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内 容 简 介 


本 书 以 实战 开发 为 原则 ， 以 Node.js 10 原生 知识 和 框架 为 主线 ， 详 细 介 绍 Node. js 开发 的 基础 知识 和 相应 案 
例 实践 ， 包 括 Node js 的 原生 模块 http. net. fs. dns, path, assert 等 ， 以 及 主流 的 Express 框架 、Meteor 框架 、 
Koa 框架 的 项 目 实际 使 用 ， 同 时 也 包含 Node.js 的 单元 测试 、Nodejjs 部 署 、 最 新 的 N-API 开发 等 方面 的 应 用 ， 还 
为 读者 提供 了 详尽 的 源 代 码 以 及 代码 注释 。 

本 书 共 14 章 ， 分 为 4 篇， 涵盖 的 主要 内 容 有 Node.js MARE, Node.js 的 编码 规范 、Node.js 包 管 理 机 制 、 
Node.js 网 络 开 发 .Nodejjs 文件 模块 使 用 、Nodejs 数据 库 开 发 .Nodejs 的 单元 测试 .前 端 框架 React HEH Express 
的 使 用 、Koa 框架 的 使 用 、Meteor 框架 的 使 用 、Nginx 的 使 用 、PM2 的 使 用 、Nodejjs 包 的 开发 与 发 布 、 个 人 博客 
的 搭建 、 任 务 清单 项 目 等 。 

本 书 内 容 丰 富 、 实 例 典型 、 实 用 性 强 ， 适 合 希望 学 习 Node js 基础 以 及 了 解 Nodejs 实际 使 用 的 人 员 阅 读 ， 尤 
其 适合 希望 通过 编码 实例 学 习 Node.js 开发 的 人 员 阅 读 。 
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Node.js 目 2009 年 发 布 伊始 便 迅 速 掀起 了 一 阵 开发 热潮 。 随 着 最 新 的 Node.js 第 10 版 
在 功能 上 的 日 至 完善 ， 其 在 Web 开发 领域 已 经 牢 牢 占据 了 属于 目 己 的 一 方 天 地 。 一 方面 ， 
Node.js 使 用 JavaScript 的 语法 使 得 服务 器 和 客户 端 使 用 同一 种 语言 进行 开发 成 为 可 能 ; 男 
一 方面 ,Node.js 通过 事件 循环 和 非 阻 塞 IO 模型 实现 的 异步 处 理 使 得 Node.js 处 理 大 量 IO 
操作 具有 独特 的 优势 。Node.js 技术 目前 非常 年 轻 并 且 正 处 于 高 速 发 展 时 期 , 无 数 的 开发 者 
下 准备 或 者 已 经 进入 这 个 领域 , 只 有 有 具有 扎实 的 语言 基础 和 丰富 的 实战 开发 经 验 才 能 在 这 
个 快速 发 展 的 领域 立足 。 

目前 图 书市 场 上 关于 Node js 零 基础 入 门 的 图 书 并 不 多 ， 从 语言 基础 开始 介绍 并 结合 
案例 实践 的 书籍 就 更 加 少 了 。 本 书 便 是 以 实战 为 主旨 ， 通 过 Node.js 开发 中 常用 的 原生 模 
块 和 典型 的 项 目 案例 ， 让 读者 全 面 、 深 入 、 透 彻 地 理解 Node.js 开发 的 各 种 热门 技术 、 各 
种 主流 框架 及 其 整合 使 用 ， 提 高 实际 开发 水 平和 项 目 实战 能 


本 书 修订 版 襄 明 
Node.js 10 已 正式 发 布 ， 这 是 自 Node.js Foundation 开展 以 来 的 第 7 个 主要 版 本 ， 本 书 
没有 包含 Node.js 10 版 本 的 全 部 新 特性 , 但 是 还 是 结合 实践 将 主要 特性 融入 全 书 中 , 包括 : 


(1) 第 1 章 介 绍 Node.js 10 版 本 的 一 些 主要 变动 和 特色 。 

(2) # 2 章 更 新 各 种 操作 系统 下 Node.js 10 环境 的 搭建 。 

(3) 第 4 章 修订 新 版 NPM 的 使 用 、 增 加 HTTP/2 模块 和 全 新 WHATWG URL 解析 器 
的 介绍 。 

(4) 第 5 SJT ZH async hooks 的 变化 ， 这 是 一 个 很 关键 的 功能 。 

(5) 第 10 章 增 加 实现 异步 请 求 的 单元 测试 新 特色 。 

(6) 第 14 章 增加 N-API 跨 版 本 兼容 的 一 些 实践 。 


本 书 特色 


1. 内 容 人 全面、 系统， 结构 合理 


为 了 便于 读者 了 解 Node.js 的 开发 ， 本 书 详细 、 系 统 地 介绍 入 门 阶段 的 原生 模块 技术 ， 
同时 涵盖 Node.js 框架 的 实战 案例 。 
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2. 叙述 完整 ， 图 文 并 成 

为 了 更 好 地 帮助 读者 进行 编程 学 习 ， 书 中 附 有 大 量 的 案例 运行 效果 图 ， 方 便 读者 香 看 
效果 。 

3. 结合 实际 ， 案 例 丰 富 

本 书 提供 了 大 量 的 实际 开发 案例 ,便于 读者 在 了 解 Node.js 知识 的 同时 进行 案例 实践 ， 
同时 书 中 所 有 的 案例 都 给 出 了 完整 的 代码 和 详细 的 注释 。 

4. 涵盖 基础 和 前 沿 知识 

本 书 既 介 绍 简 单 的 网 络 开 发 、 数 据 库 开发 等 入 门 知 识 ， 又 罕 插 Express. Koa, Meteor 
等 框架 的 前 沿 知识 ， 让 读者 在 了 解 基础 的 同时 紧 跟前 沿 技术 的 步伐 。 

5. 提供 大 量 的 源 代 码 ， 全 部 基于 最 新 的 Node.js 10 实现 


本 书 提供 大 量 的 源 代 码 ， 全 部 代码 均 基 于 Node.js 10 框架 实现 。 另 外 ， 所 涉及 的 全 部 
源 代 码 都 将 开放 给 读者 ， 以 便于 学 习 。 


本 书 内 容 


第 1 篇 Nodejs 概述 和 开发 环境 的 搭建 (S 1—2 章 ) 

本 篇 介绍 开发 Node.js 的 主要 特点 、 发 展 历史 和 开发 环境 的 搭建 ， 主 要 包括 Node.js 的 
特性 、 应 用 场景 、 开 发 环境 的 搭建 、 开 发 工具 的 选择 以 及 Node.js 10 的 新 特性 。 

第 2 篇 Node.js 编程 基础 (第 3—7 章 ) 

本 篇 介绍 Node.js 常用 原生 模块 的 开发 基础 ， 主 要 包括 Node js 的 包 管 理 、 模 块 机 制 以 
及 Node.js 开发 中 最 常用 的 文件 模块 、 网 络 开 发 模块 、 数 据 库 开发 模块 等 知识 。 

第 3 篇 ”Node.js 实践 〈 第 8—11 章 ) 

本 篇 主要 介绍 Node.js 在 实际 开发 中 的 运用 ， 主 要 包括 Node.js 的 Express. Meteor HE 
BB. Node.js 的 单元 测试 、Node.js 部 署 中 的 实际 运用 。 

第 4 篇 Nodejs 项 目 案例 〈 第 12—14 章 ) 


本 篇 主要 介绍 4 个 项 目 案例 的 开发 过 程 ， 主 要 包括 个 人 博客 系统 、 任 务 清 单 、NPM 包 
和 N-API 设计 ,涉及 Express 和 Meteor 框架 的 使 用 以 及 需求 分 析 、 数 据 库 设计 、 业 务 层 设 
计 和 表示 层 设计 的 详细 过 程 ， 还 涉及 NPM 包 的 开发 与 发 布 、Node.js 10 新 发 布 的 N-API 
功能 的 设计 与 实现 。 


代码 下 载 


本 书 示 例 源 代码 可 以 扫 拉 下 面 的 二 维 码 下 载 。 如 果 下 载 有 问题 ， 或 者 对 本 书 有 什么 疑 
问 和 建议 ， 请 联系 booksaga@163.com， 邮 件 主题 为 “Node.js 10 实战 ”。 


本 书 读者 
@ 所 有 Web 前 端 开发 人 员 。 
想 要 全 面 学 习 Node.js 开发 技术 的 人 员 。 
广大 Web 开发 程序 员 。 
Node.js 程序 员 。 
想 要 进入 Node.js 领域 的 前 端 开发 人 员 。 
希望 提高 项 目 开 发 水 平 的 人 员 。 
专业 培训 机 构 的 学 员 。 
需要 一 本 案头 必 备 查询 手册 的 Web 开发 人 员 。 


本 书 第 1 版 由 急 如 寄主 笔 ， 第 2 版 由 王 金 柱 修 订 整 理 ， 其 他 创作 人 员 还 有 天 贯 文 、 薛 
淑 英 、 重 山海 ， 在 此 表示 感谢 。 由 于 时 间 因 素 和 作者 水 平 有 限 ， 读 者 在 阅读 中 发 现 本 书 存 
在 什么 疑问 或 者 建议 ， 敬 请 联系 作者 。 
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Node.js 是 一 个 基于 JavaScript 的 路 平台 开发 语言 。 随 着 全 栈 开 发 技术 的 不 断 推 广 和 日 益 盛 
ÍT, Node.js 逐渐 成 为 一 种 非常 流行 的 开发 语言 。 本 章 主要 对 Node.js 进行 整体 介绍 ， 并 对 其 发 
展 历史 和 相关 版 本 进行 详细 的 说 明 ， 同 时 会 介绍 在 今后 开发 中 所 涉及 的 基础 知识 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


Node.js 的 发 展 历史 和 特点 。 

V8 引擎 的 介绍 及 其 与 Node.js 之 间 的 关系 。 
Node.js 的 一 些 应 用 场景 。 

Node.js 在 中 国 的 发 展 及 相关 资源 。 


L. Node.js 简介 


Node.js 是 一 个 基于 Google 所 开发 的 浏览 器 Chrome V8 引擎 的 JavaScript 运 行 环境 .Node.js 
使 用 多 种 先进 的 技术 ， 其 中 包括 事件 驱动 和 非 阻 塞 式 IO 模型 ， 使 其 轻 量 又 高 效 ， 受 到 众多 开 
发 者 的 追捧 。 

简单 来 说 ，Node.js 就 是 运行 在 服务 端的 JavaScript， 可 以 稳定 地 在 各 种 平台 下 运行 ， 包 括 
Linux, Windows, Mac OS X. SunOS 和 FreeBSD 等 众多 平台 。 

作为 Web 前 端 最 重要 的 语言 之 一 ，JavaScript 一 直 是 前 端 工 程 师 的 专利 。 不 过 ，Node.js 
是 一 个 后 端的 JavaScript 运行 环境 (支持 的 系统 包括 Linux. Windows) ， 这 意味 着 我 们 可 以 
编写 系统 级 或 者 服务 器 端的 JavaScript 代码 ， 交 给 Node.js 来 解释 执行 。 

简单 的 Node.js 命令 类 似 于 : 


#node helloworld.js 


由 于 采用 V8 引擎 执行 JavaScript 的 速度 非常 快 , 因此 Node.js 开发 出 来 的 应 用 程序 性 能 非 
常 好 。Node.js 已 经 成 为 全 栈 开 发 的 首选 语言 之 一 ， 并且 从 它 衍生 出 众多 出 色 的 全 栈 开 发 框架 。 
Node.js 已 经 在 全 球 被 众多 公司 使 用 ， 包 括 创业 公司 Voxer、Uber 以 及 沃尔玛 、 微 软 这 样 的 知 
名 公司 。 它 们 每 天 通过 Node 处 理 的 请 求 数 以 亿 计 ， 可 以 说 在 要 求 苛刻 的 服务 器 系统 ，Node.js 
也 可 以 轻松 胜任 。 
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Node.js 还 包括 一 个 完善 的 社区 。 在 Node.js 的 官方 网 站 (http://nodejs.org/) 可 以 找到 大 量 
的 文档 和 示例 程序 ， 并 且 Node.js 还 有 一 个 强大 的 包 管 理 嚣 NPM。 渐 渐 地 ， 越 来 越 多 的 人 参 
与 到 本 项 目 中 来 ， 可 用 的 第 三 方 模块 和 扩展 增长 迅猛 ， 而 且 质 量 也 在 不 断 提 升 ，Node.js 已 经 
是 全 球 较 大 的 开源 库 生 态 系 统 之 一 。 


Node.js 不 是 一 个 JavaScript 应 用 ,而 是 一 个 JavaScript 的 运行 环境 , 由 C++ 语言 编写 而 成 。 


1 .人 ”Nodejs 的 发 展 历史 和 特点 


任何 语言 或 框架 都 不 是 一 天 形成 的 ， 而 是 经 过 漫长 的 测试 、 发 布 、 再 测试 、 再 发 布 的 迭代 
过 程 。 本 节 就 来 介绍 一 下 Node.js 的 发 展 过 程 。 


1.2.1 ”Node.js 发 展 历史 


Node.js 的 创始 人 是 大 名 昂 晶 的 Ryan Dahl。 他 本 来 是 学 数学 的 ，2008 年 年 末 一 个 偶然 的 
机 会 让 他 了 解 到 Google 推出 了 一 个 新 的 浏览 器 Chrome Marar JavaScript 引擎 V8。 他 听 说 
这 是 一 个 为 了 更 快 的 Web 体验 而 专门 制作 的 更 快 的 JavaScript 引擎 , V8 能 够 让 Web 应 用 大 大 
提速 。 当 时 , 他 正在 寻找 一 个 新 的 编程 平台 来 做 网 站 ,他 非常 希望 能 找到 一 种 语言 提供 先进 的 
推送 功能 并 集成 到 网 站 中 ， 而 不 是 采用 传统 的 方式 一 一 不 断 轮 询 拉 取 数 据 。 

Ryan Dahl 对 C/C++ 和 系统 调用 非常 熟悉 ， 他 使 用 系统 调用 (用 C) 实现 消息 推送 这 样 的 
功能 。 如 果 只 使 用 非 阻塞 式 Socket， 每 个 连接 的 开销 都 会 非常 小 。 在 小 规模 测试 中 ， 它 能 同时 
处 理 几 千 个 闲置 连接 ， 并 可 以 实现 相当 大 的 吞吐 量 。 但是， 他 并 不 想 使 用 C， 他 希望 采用 另 一 
种 漂亮 、 灵 活 的 动态 语言 。 他 最 初 也 希望 采用 Ruby 来 写 Node.js， 但 是 后 来 发 现 Ruby 虚拟 机 
的 性 能 不 能 满足 要 求 ， 后 来 便 答 试 采 用 V8 引擎 ， 所 以 选择 了 C++ 语言 。 

2009 年 2 月 ，Ryan Dahl 首次 在 自己 的 博客 上 宣布 准备 基于 V8 创建 一 个 轻 量 级 的 Web 
服务 器 并 提供 一 套 库 ， 并 在 2009 年 5 月 正式 在 GitHub 上 发 布 最 初版 本 的 部 分 Node.js 包 。 随 
后 几 个 月 里 ， 有 人 开始 使 用 Node.js 开发 应 用 。 实 践 证 明 ，JavaScript 13 3EFH Socket 配合 得 
相当 完美 ， 只 需要 简单 的 几 行 JavaScript 代码 就 可 以 构建 出 非常 复杂 的 非 阻塞 服务 器 。 

2010 年 年 底 ，Node.js 获得 云 计 算 服 务 商 Joyent 资助 。 创 始 人 Ryan Dahl 加 入 Joyent， 全 
职 负责 Node.js HRE. Node.js 从 此 以 后 迅猛 发 展 ， 并 成 为 一 种 流行 的 开发 语言 。 

在 官方 网 站 上 ，Node.js 的 版 本 号 是 从 0.1.14 开始 的 ， 每 个 发 布 版 本 对 应 不 同 的 V8 引擎 
版 本 和 NPM 包 管 理 嚣 版本， 截至 作者 写作 本 书 时 ， 最 新 的 版 本 为 V10.9.0， 其 各 个 主要 版 本 
的 具体 发 布 时 间 参 见 表 1-1 (2014 年 以 后 ) o 
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表 1-1 Node js 版 本 的 发 布 时 间 (2014 FUA) 


Node.js V10.9.0 
Node.js v8.10.0 
Node.js v5.0.0 
Node.js v4.2.0 


从 1X 到 3X 版 本 ，Nodejs 的 名 称 曾经 被 修改 为 iojs， 从 Node.js 4.0.0 开始 ，iojs 的 全 部 
代码 就 合并 到 Nodejs 的 主干 发 布 版 本 之 中 了 。 


Node.js 的 发 展 大 致 可 以 分 为 以 下 4 个 阶段 。 


(1) 发 展 初期 。 创 始 人 Ryan Dahl 市 着 他 的 团队 开发 出 以 Web 为 中 心 的 Web.js， 一 切 都 
非常 混乱 ，API 大 多 处 于 研究 阶段 。 

(2) 快速 发 展 时 期 。Node.js 的 核心 用 户 Isaac Z. Schlueter FA HAE Node.js 如 今 地 位 
的 重要 工具 一 一 NPM, 同时 也 为 他 后 来 成 为 Ryan 的 接班 人 葛 定 了 基础 ,之 后 Connect, Express. 
Socket.io 等 库 的 出 现 吸引 了 一 大 波 爱 好 者 加 入 Node.js 开发 者 的 阵营 中 来 .CoffeeScript 的 出 现 
更 是 让 不 少 Ruby 和 Python 开发 者 找到 了 学 习 的 理由 。 其 间 一 大 波 以 Node.js 作为 运行 环境 的 
CLI 工 具 涌 现 ,其 中 不 乏 用 于 加 速 前 痛 开 发 的 优秀 工具 ,如 Less、UglifyJS、Browserify、Grunt 
等 。 这 个 阶段 Node. js 的 发 展 势如破竹 。 

(3) 不 稳定 时 期 。 经 过 一 大 批 一 线 工 程 师 的 探索 实践 后 , Node.js 开始 进入 时 代 的 更 迭 期 ， 
新 模式 代 蔡 旧 模 式 ， 新 技术 代 蔡 旧 技术 ， 好 实践 代 蔡 旧 实 践 。ES 6 也 开始 出 现在 Node.js 世界 
中 。ES 6 的 发 展 越 来 越 快 ，V8 也 对 ES 6 中 的 部 分 特性 实现 了 支持 ， 如 Generator 等 。 

(4) 稳步 发 展 时 期 。 随 着 ES 2015 的 发 展 和 最 终 定稿 ， 一 大 批 利 用 ES 2015 特性 开发 的 
新 模块 出 现 ， 如 原 Express 核心 团队 所 开发 的 Koa。Node.js 之 父 Ryan Dahl 退出 Node.js 的 核 
心 开发 ， 转 而 做 其 他 的 研究 项 目 。Ryan Dahl 的 接任 者 Isaac Schlueter (也 是 Node.js 的 核心 构 
建 者 ) 将 Node.js 一 直 开 发 下 去 并 不 断 完善 。 


1.2.2 Node js 未 来 版 本 规划 


Node.js 的 核心 团队 已 经 为 Nodejjs 的 长 远 发 展 做 好 了 详细 计划 。 图 1.1 所 示 是 Node.js 到 
2019 年 10 月 为 止 的 所 有 版 本 计划 及 发 布 时 间 表 。 
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Oct 2017 Jan 2018 Apr usai Jul zoas Oct 2018 Jan ZOLA Apr 2019 jul 2019 Oct 2019 

Master ET x | x x 
Nodejs4 WYA 3 n e 

Node.js 6 aieia MAI CE 


| 
Node.js B ACTIVE 


Node.js 9 Walhi = 


Node.js 10 CURRENT ACTIVE 


1.1 计划 及 发 布 时 间 表 


1.2.3 Node.js 的 结构 


前 面 介绍 了 Nodejjs 是 一 个 完整 的 JavaScript 开发 环境 ， 并 且 是 基于 Google 的 Chrome V8 
引擎 进行 代码 解释 的 。 它 在 设计 之 初 就 已 经 定位 用 来 解决 传统 Web 开发 语言 所 遇 到 的 诸多 问 
题 ， 所 以 Node js 有 很 多 其 他 开发 语言 所 不 具备 的 优点 ， 包 括 事件 驱动 、 异 步 编 程 等 。 下 面 我 
们 先 介 绍 一 下 Node.js 的 结构 ， 然 后 详细 分 析 Node.js 的 一 些 主要 特点 。 

图 1.2 中 ， 浅 色 部 分 是 由 JavaScript 编写 的 ， 深 色 部 分 是 由 C/C++ 完成 的 。 从 图 1.2 中 可 
以 看 出 ，Node.js 的 结构 大 致 分 为 以 下 3 个 层次 。 


© Nodejs 标准 库 .这 部 分 是 由 JavaScript 编写 的 , 即 我 们 使 用 过 程 中 能 直接 调用 的 API 
在 源码 中 的 lib 目录 下 可 以 看 到 。 

© Nodebindings. 这 一 层 是 JavaScript 与 底层 C/C++ 能 够 沟通 的 关键 ,前 者 通过 bindings 
调用 后 者 ， 相 互 交换 数据 。 

© 支撑 Nodejs 运行 的 基础 构件 。 这 层 内 容 比 较 多 ， 下 面 详细 介绍 。 


支撑 Node.js 运行 的 基础 构件 是 由 C/C++ 实现 的 ， 其 中 包括 四 大 部 分 。 


@ V8:Google 推 出 的 JavaScript VM, 也 是 Node.js 使 用 JavaScript 的 关键 , 它 为 JavaScript 
提供 了 在 非 浏 览 器 端 运行 的 环境 ， 它 的 高 效 是 Node.js 之 所 以 高 效 的 原因 之 一 。 

© libuv: A Node.js 提供 了 跨 平 台 、 线 程 池 、 事 件 池 、 异 步 IO 等 能 力 ， 是 Node.js 如 
此 强大 的 关键 。 

© C-ares: J T APAE DNS 相关 的 能 

© http parser, OpenSSL, zlib 等 : 提供 包括 HTTP 解析 、SSL、 数 据 压缩 等 能 
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1.2.4 ”Node.js v10 的 特点 及 新 变化 


都 说 Node.js 强大 ， 这 种 强大 体现 在 很 多 方面 ， 如 事件 驱动 、 异 步 处 理 、 非 阻塞 IO 等 。 
这 里 将 介绍 Node.js 具备 的 不 同 于 其 他 框 染 的 特点 。 


1. 事件 驱动 


在 某 些 传统 语言 的 网 络 编程 中 ， 我 们 会 用 到 回调 函数 ， 比 如 当 Socket 资源 达到 某 种 状态 
HJ, 注册 的 回调 函数 就 会 执行 。 Node.js 的 设计 思想 以 事件 驱动 为 核心 , 它 提供 的 绝 大 多 数 API 
都 是 基于 事件 的 、 异 步 的 风格 。 以 Net 模块 为 例 , 其 中 的 net.Socket 对 象 的 事件 有 connect, data, 
end, timeout, drain, error, close 等 。 使 用 Nodejjs 的 开发 人 员 需 要 根据 自己 的 业务 逻辑 注册 
相应 的 回调 函数 。 这些 回 调 函 数 都 是 异步 执行 的 。 这 意味 着 虽然 在 代码 结构 中 这 些 函 数 看 似 是 
依次 注册 的 ， 但 是 它们 并 不 依赖 于 上 自身 出 现 的 顺序 ， 而 是 等 待 相应 的 事件 触发 。 

事件 驱动 的 优势 在 于 充分 利用 了 系统 资源 , 执行 代码 无 须 阻 塞 等 符 某 种 操作 完成 , 有 限 的 
资源 可 以 用 于 其 他 的 任务 。 此 类 设计 非常 适合 后 端的 网 络 服务 编程 , Node.js 的 目标 也 在 于 此 。 
在 服务 器 开发 中 ， 并 发 的 请 求 处 理 是 一 个 大 问题 ， 阻 寨 式 的 函数 会 导致 资源 浪费 和 时 间 延 迟 。 
通过 事件 注册 、 异 步 函 数 ， 开 发 人 员 可 以 提高 资源 的 利用 率 ， 性 能 也 会 改善 。 


2. 异步 、 非 阻塞 1O 


从 Node.js 提供 的 文 持 模块 中 ， 我 们 可 以 看 到 包括 文件 操作 在 内 的 许多 函数 都 是 异步 执行 
的 。 这 和 传统 语言 存在 区 别 。 为 了 方便 服务 器 开发 ，Nodejjs 的 网 络 模块 特别 多 ， 包 括 HTTP, 
DNS, NET. UDP, HTTPS. TLS 等 。 开 发 人 员 可 以 在 此 基础 上 快速 构建 Web 服务 器 。 

一 个 异步 VO 的 大 致 流程 如 图 1.3 所 示 ， 讲 解 如 下 。 


(1) 发 起 IO 调用 
O 用 户 通过 JavaScript 代码 调用 Node 核心 模块 ， 将 参数 和 回调 函数 传 入 核心 模块 。 
@ Node 核心 模块 会 将 传 入 的 参数 和 回调 函数 封装 成 一 个 请 求 对 象 。 
O 将 这 个 请 求 对 象 推 入 LO 线程 池 等 待 执行 。 
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(4) JavaScript 发 起 的 异步 调用 结束 ，JavaScript 线程 继续 执行 后 续 操 作 。 
(2) 执行 回调 
D VO 操作 完成 后 会 将 结果 存储 到 请 求 对 象 的 result 属性 上 ， 并 发 出 操作 完成 的 通知 。 
D 每 次 事件 循环 时 会 检查 是 否 有 完成 的 IO 操作 ， 如 果 有 就 将 请 求 对 象 加 入 VO 观察 者 
队列 中 ， 之 后 当 作 事 件 处 理 。 
@) 处 理 IO 观察 者 事件 时 会 取出 之 前 封装 在 请 求 对 象 中 的 回调 函数 , 执行 这 个 回调 函数 ， 
并 将 result 当 作 参数 ， 以 完成 JavaScript 回调 的 目的 。 


Node.js 的 网 络 编程 非常 方便 ， 提 供 的 模块 (在 这 里 是 HTTP) 开放 了 容易 上 手 的 API 接 
口 ， 短 短 几 行 代码 就 可 以 构建 服务 器 。 
Node apps pass async 


1 tasks to the event loop, 
qlong with q callback 


The event loop efficiently 
manages a thread pool and 
executes tasks efficiently... 


. Thread Thread Thread 
(function, callback) l 2 n 


Task 2 


< 
X Nodejj 


Event Loop 1-:: 


Callback1 () 


...Qnd executes each 
3 callback as tasks complete 


13 异步 IO 的 流程 


3. 性 能 出 众 


创始 人 Ryan Dahl 在 设计 的 时 候 就 考虑 了 性 能 方面 的 问题 ， 选 择 C++ 和 V8， 而 不 是 Ruby 
或 者 其 他 的 虚拟 机 。Node.js 在 设计 上 以 单 进程 、 单 线程 模式 运行 。 事 件 驱 动机 制 是 Node.js 
通过 内 部 单线 程 高 效率 地 维护 事件 循环 队列 来 实现 的 ， 没 有 多 线程 的 资源 占用 和 上 下 文 切 换 。 
这 意味 着 面 对 大 规模 的 HTTP 请 求 ，Node.js 是 凭借 事件 驱动 来 完成 的 。 从 大 量 的 测试 结果 分 
析 来 看 ，Node.js 的 处 理性 能 是 非常 出 色 的 ， 在 QPS 达到 16700 次 时 ， 内 存 仅 占用 30MB (Jl 
试 环境 : RHEL 5.2. CPU 2.2GHz、 内 存 4GB) 。 


4. 单线 程 


Node.js 和 大 名 昂昂 的 Nginx 一 样 ,都 是 以 单线 程 为 基础 的 。 这 正 是 Node.js 保持 轻 量 级 和 
高 性 能 的 关键 ,也 是 Ryan Dahl 设计 Node.js 的 初 囊 。 这 里 的 单线 程 是 指 主 线程 为 “单线 程 ”， 
所 有 阻塞 的 部 分 交 给 一 个 线程 池 人 处理, 然后 这 个 主线 程 通 过 一 个 队列 跟 线程 池 协 作 。 我 们 写 的 
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JS 代码 部 分 不 用 再 关心 线程 问题 ， 代 码 也 主要 由 一 堆 callback 回调 构成 ， 然 后 主线 程 在 循环 
过 程 中 适时 调用 这 些 代 码 。 

单线 程 除了 保证 Node js 的 高 性 能 之 外 ， 还 保证 了 绝对 的 线程 安全 ， 使 开发 者 不 用 担心 同 
一 变量 同时 被 多 个 线程 读 写 而 造成 的 程序 裔 省 。 


5. 新 变化 


Node.js V10 版 本 的 正式 发 布 标志 着 Node.js Foundation 目 诞 生 以 来 走 到 了 第 7 个 主要 版 
本 ,并 且 该 版 本 在 2018 年 10 月 成 为 下 一 个 LTS 分 支 。 关 于 Node.js V10 版 本 的 新 功能 和 新 变 
化 基本 概括 如 下 。 


(1) 最 新 的 Nodejs V10 版 本 目 带 了 定制 化 的 Node-ChakraCore 引擎 ， 其 新 增 的 功能 具体 
包括 : 


© 全 面 文 持 N-API。 

@) 可 轻松 通过 新 的 Visual Studio Code Extension 进行 Time-Travel 调试 。 
© 文 持 TID 的 生成 器 和 异步 函数 。 

(4) 支持 Inspector 协议 。 

© 增强 稳定 性 和 其 他 各 种 改进 。 


(2) 最 新 的 Node.js V10 版 本 做 了 如 下 重要 的 更 新 : 


(CD N-API native addons API 已 结束 实验 状态 。 

@) Async hooks 过 时 的 实验 性 async hooks API 已 被 删除 。 

(3) Child Process 忽略 了 未 定义 的 env 属性。 

(4) Console 新 增 了 console.table0 方 法 。 

@ 关于 Crypto 功能 : 

@ crypto.createCipher() Z 法 和 crypto.createDecipherO 方法 已 经 被 弃 用 ， 同 时 被 
crypto.createCipheriv0 方 法 和 crypto.createDecipheriv(0 方 法 所 代替 。 

@ decipher.finaltol0 方 法 已 被 弃 用 。 

© cryptoDEFAULT ENCODING 属性 已 被 弃 用 。 

@ 新 增 ECDH.convertKey() 方 法 。 

© crypto.fips 属性 已 经 被 弃 用 。 

© 依赖 更 新 : 

@ Google V8 已 升级 至 6.6 版 本 。 

© OpenSSL 已 升级 至 1.1.0h 版 本 。 


1.2.5 Node js 的 应 用 场景 
Node.js 可 以 应 用 到 很 多 方面 ， 可 以 说 从 Node.js 开始 ， 程 序 员 可 以 使 用 JavaScript 来 开发 
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服务 器 端的 程序 了 。Nodejs 为 前 端 开发 程序 员 提 供 了 便利 ， 并 在 各 大 网 站 中 承担 重要 角色 ， 
成 为 开发 高 并 发 大 型 网 络 应 用 的 关键 技术 。Web 站 点 早已 不 局 限于 内 容 的 呈现 ， 很 多 交互 型 
和 协作 型 环境 也 逐渐 被 搬 到 了 网 站 上 , 而 且 这 种 需求 还 在 不 断 地 增长 。 这 就 是 所 谓 的 数据 密集 
型 实时 (data-intensive real-time) 应 用 程序 ， 比 如 在 线 协作 的 白板 、 多 人 在 线 游戏 等 ， 这 种 
Web 应 用 程序 需要 一 个 能 够 实时 啊 应 大 量 并 发 用 户 请 求 的 平台 文 撑 它们 , 这 正 是 Nodejjs 擅长 
的 领域 。 此 外 ，Nodejjs 的 路 平台 特性 是 使 用 Node.js 语言 开发 流行 的 男 一 大 原因 。 

Nodejjs 的 主要 应 用 场景 如 下 : 


tweets 。 


FA ? 


JSON APIs 一 一 构建 一 个 Rest/JSON API 服务 ，Node.js 可 以 充分 发 挥 其 非 阻塞 IO 模 
型 以 及 JavaScript 对 JSON 的 功能 支持 (如 JSON.stringfy 函数 ) 。 

单 页面 、 多 Ajax 请 求 应 用 一 一 如 Gmail， 前 端 有 大 量 的 异步 请 求 ， 需 要 服务 后 端 有 
基于 Node.js 开发 UNIX 命令 行 工具 一 一 Node.js 可 以 大 量 生产 子 进程 ， 并 以 流 的 方 
式 输 出 ， 这 使 得 它 非常 适合 做 UNIX 命令 行 工具 。 

流 式 数据 一 一 传统 的 Web 应 用 通常 会 将 HTTP 请 求 和 响应 看 成 原子 事件 ,而 Node.js 
会 充分 利用 流 式 数据 这 个 特点 构建 非常 酪 的 应 用 ， 如 实时 文件 上 传 系 统 transloadit。 
准 实时 应 用 系统 一 一 如 聊天 系统 、 微 博 系 统 , 但 JavaScript 是 有 垃圾 回收 机 制 的 ， 这 
就 意味 着 系统 的 响应 时 间 是 不 平滑 的 (GC 垃圾 回收 会 导致 系统 这 一 时 刻 停止 工作 ) 。 
如 果 想 要 构建 硬 实时 应 用 系统 ，Erlang 是 一 个 不 错 的 选择 。 


例如 ， 实 时 互动 交互 比较 多 的 社交 网 站 ( 像 Twitter 这 样 的 公司 〉 必 须 接收 tweets 并 将 其 
写 入 数据 库 。 实 际 上 ， 每 秒 几 乎 有 数 千 条 tweet 到 达 ， 数 据 库 不 可 能 及 时 处 理 高 峰 时 段 所 需 的 
写 入 数量 。Node 成 为 这 个 问题 解决 方案 的 重要 一 环 。Node 能 处 理 数 万 条 入 站 tweet。 它 能 

速 而 又 轻松 地 将 tweets 写 入 一 个 内 存 排 队 机 制 (例如 memcached) ， 男 一 个 单独 进程 可 以 从 
那里 将 tweets 写 入 数据 库 。Node 能 处 理 每 个 连接 而 不 会 阻塞 通道 ， 从 而 能 够 捕获 尽 可 能 多 的 


虽然 看 起 来 Node.js 可 以 做 很 多 事情 ， 并 且 拥 有 很 高 的 性 能 ， 但 是 Node.js 并 不 是 万 能 的 ， 
有 一 些 类 型 的 应 用 ，Node.js 可 能 处 理 起 来 会 比较 吃力 。 例 如 ，CPU 密集 型 的 应 用 、 模 板 演 染 、 
压缩 /解压 缩 、 加 /解密 等 操作 都 是 Node.js 的 软肋 。 


Node.js 在 中 国 的 发 展 


Node.js 在 发 展 初 期 ， 国 内 就 有 大 量 的 开发 者 开始 持续 关注 了 。 随 着 Node.js 的 不 断 成 
很 多 国内 的 公司 都 开始 采用 这 一 新 技术 。2013 年 、2014 年 、2015 年 的 JS 中 国 开发 
者 大 会 都 将 Node.js 作为 主要 的 宣讲 内 容 ，Node.js 也 受 国 内 的 开发 爱好 者 追捧 。Node.js 
开发 者 在 国内 的 数量 不 断 增 加 ， 并 涌现 出 很 多 组 织 和 机 构 来 自发 地 进行 推广 和 技术 分 享 。 
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国内 的 各 大 视频 培训 网 站 上 都 有 Nodejjs 开发 的 培训 教程 ， 各 大 门户 网 站 也 都 或 多 或 少 地 
采用 了 Nodejjs 的 开发 技术 ， 淘 宝 、 网 易 、 百 度 等 有 很 多 项 目 都 运行 在 Node.js 之 上 。 阿 里 云 
是 在 这 方面 比较 靠 前 的 公司 ， 其 云 平台 率先 支持 Node.js 的 开发 。 淘 宝 也 为 Node.js 搭建 了 国 
内 的 NPM 镜像 网 站 ， 方 便 国内 的 开发 者 下 载 各 种 开发 包 。 


1.3.1 Node.js 中 文 资源 汇总 


(1) 有 关于 Node.js 最 新 版 本 的 下 载 和 新 闻 、 丰 富 的 文档 资料 ， 非 常 值得 认真 学 习 ， 是 
Node.js 开发 爱好 者 不 容错 过 的 网 站 ， 网 址 为 http:/ http://nodejs.cn/。 

(2) CNode 社区 ， 由 一 批 热爱 Node.jjs 技术 的 工程 师 发 起 ， 已 经 吸引 了 各 个 互联 网 公司 
的 专业 技术 人 员 加 入 ， 是 目前 国内 非常 具有 影响 力 的 Node.js 开源 技术 社区 ， 致 力 于 Node.js 
的 技术 研究 ， 并 有 论坛 会 定期 组 织 一 些 技术 交流 活动 ， 网 址 为 https://cnodejs.org/。 

(3) 全 栈 技术 社区 , 是 一 个 专业 的 Node js 中 文 知 识 分 享 社区 ,致力 于 普及 Node.js 知识 ， 
分 享 Node.js 研究 成 果 ， 努 力 推进 Node js 在 中 国 的 应 用 和 发 展 ， 网 站 有 大 量 的 技术 博客 和 文 
章 ， 各 个 级 别 的 开发 者 都 能 找到 适合 自己 学 习 的 资料 ， 网 址 为 https://www.nodejsnet.com/。 

(4) 淘宝 NPM 镜像 ， 是 一 个 完整 npmjs.org 镜像 ， 可 以 用 此 代 蔡 官方 版 本 ， 同 步 频 率 为 
每 10 分 钟 一 次 ， 以 保证 尽量 与 官方 服务 同步 ， 网 址 为 https://npm.taobao.org/。 


每 年 的 JS 中 国 开发 者 大 会 和 各 种 Node js 分 享 沙龙 都 是 很 好 的 学 习 Node.js 开发 技术 和 交 
流 的 机 会 。 一 个 开发 者 要 时 刻 保 持 谦虚 的 心态 ， 并 不 断 学 习 最 新 的 技术 。 这 对 开发 者 来 说 是 一 
种 基本 能 力 和 素养 。 


1.3.2 Node js 的 发 展 和 未 来 


Node.js 在 创建 之 初 是 为 了 开发 即时 通信 的 Web 应 用 ， 当 然 现 在 的 Node.js 已 绝 不 只 是 一 
套 简 单 的 Web 堆栈 一 一 作为 一 项 技术 ， 它 在 多 个 层面 焕发 出 动 动 生机 ， 价 值 已 经 远 远 超出 了 
第 见 Web 服务 器 的 范畴 。 
例如 ,一 球 由 Jacob Groundwater 打造 的 项 目 NodeOS, 其 创始 人 希望 围绕 Linux 核心 建立 
一 套 新 型 环境 。 其 中 ，Node.js 作为 “shell”， 而 Node 的 NPM 则 被 用 于 系统 包 管 理 器 。 截 至 
目前 ，NodeOS 的 首 个 版 本 已 经 创建 完成 。Node.js 还 被 用 来 作为 硬件 控制 的 工具 代替 C/C++， 
Noduino 允许 大 家 经 由 WebSocket 或 者 串 连 接 实现 Arduino 访问 。 该 项 目 虽 然 尚 处 于 起 步 阶 段 ， 
但 是 驱动 主板 上 的 LED 模块 、 捕 捉 来 自 Arduino 的 事件 〈 例 如 按 下 按钮 ) 等 常见 功能 都 已 经 
可 以 正常 支持 ， 以 后 就 可 以 通过 网 页 直接 控制 Arduino 硬件 和 其 他 物 联 网 设备 了 。 
2016 Œ, Nodejs 发 布 了 两 个 重量 级 的 版 本 : v4.4.0 LTS (长 期 支持 版 本 ) 和 v5.9.0 Stable 
(稳定 版 本 ), 并 且 成 立 了 Nodejs 基金 会 , 能够 让 Node.js 在 未 来 有 更 好 的 开源 社区 支持 。Node.js 
基金 会 的 创始 成 员 包 括 Joyent、IBM、Paypal、 人 微软 、Fidelity 和 Linux 基金 会 。Node.js 的 core 
(核心 ) 己 经 非常 稳定 并 逐步 被 广大 开发 者 认可 ， 进 而 进行 大 规模 使 用 。 闭 名 的 Node.js 包 管 
理工 具 NPM 在 2014 年 成 为 软件 开发 世界 中 包 管 理工 具 的 龙头 老大 ， 现 在 NPM 包含 的 模块 数 
是 Java 以 及 Ruby 的 包 管 理工 具 模 块 数 的 两 倍 。 图 1.4 反映 了 NPM 包 管 理工 具 的 增长 情况 。 
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Module Counts 


400000 


BW CPAN 
而 GoDoc (Go) 
E Maven Central (Java) 
E npm (node js) 
300000 E nuget(.NET) 

E Packagist (PHP) 
250000 f 国 PyPI 


350000 


E Rubygems.org 


1.4 NPM 包 管 理工 具 的 增长 情况 


e 元 数据 来 源 于 http://www.modulecounts.com/。 


2018 年 上 半年 , Nodejs AI NPM 的 普及 率 进 一 步 提 升 。 大 公司 对 Node.js 的 应 用 持续 提升 ， 
并 推出 更 多 对 企业 级 友好 功能 的 长 期 计划 ， 可 能 预示 着 Node Js 在 企业 中 会 持续 增长 ， 蔡 换 一 
部 分 像 Java 和 .NET 这 样 的 典型 解决 方案 .Node.js 诞生 于 2009 年 ,其 年 龄 远 不 如 Python, Ruby, 
PHP 等 老牌 开发 语言 ， 但 是 它 成 为 有 史 以 来 发 展 最 快 的 开发 工具 。 可 以 预见 ， 在 未 来 的 几 年 
Node.js 技术 会 不 断 发 展 ， 成 为 Web 开发 的 核心 技术 ， 并 从 现 有 的 Java, PH 等 语言 中 争夺 到 
更 多 的 份额 。 


1 .4 温 故 知 新 
学 完 木 章 内 容 ， 读 者 需要 回答 
1. Node.js 有 哪 几 大 主要 特性 ? 


2. Node.js V10 有 哪些 新 变化 ? 
3. 在 选择 Node.js 开发 的 时 候 有 哪些 注意 事项 ? 


= 2 =ë 


< 部署 Node.js 开 发 环境 > 


部 署 Node.js 开发 环境 是 正式 接触 Node js 的 第 一 步 。Node.js 可 以 在 多 个 不 同 的 平台 稳定 
运行 ， 并 且 具 有 民 好 的 兼容 性 。 但 是 Node.js 部 署 在 不 同 操作 系统 下 的 方法 并 不 完全 一 致 ， 本 
章 主要 介绍 如 何在 各 个 操作 系统 平台 下 进行 Node.js 的 部 署 。 

通过 本 章 的 学 习 ， 可 以 掌握 以 下 内 容 : 


Windows 部 署 : 学 会 如 何在 Windows 操作 系统 上 安装 Node js. 

Linux HA: 学 会 在 各 种 Linux 发 行 版 本 上 部 团 Node.js 开发 环境 。 

Mac OS X 部署 : 学 会 在 Mac 的 OS X 系统 上 部 署 Node js 开发 环境 。 

树 莓 派 3 部 署 : 学 习 如 何 使 用 nvm 在 树 莓 派 3 上 部 署 Node.js 开发 环境 。 
开发 工具 介绍 : 介绍 Sublime Text 3 的 使 用 方法 和 Node.js 插件 的 安装 。 


在 Windows 10 下 部 署 Node.js 开发 环境 


Node.js 可 以 在 Windows 系统 下 稳定 运行 , 本 节 主 要 介绍 Windows 10 下 的 Node.js 环境 部 

£. fE Windows 中 进行 Node.js 环境 部 署 是 相对 比较 简单 的 ， 首 先 从 Node.js 的 官方 网 站 

(https://nodejs.org/en/download/) 上 下 载 最 新 的 Windows 安装 包 ， 国 内 用 户 可 以 通过 Node.js 

官方 中 文 站 点 (http://nodejs.cn/download/) 进行 下 载 。 中 文 站 点 的 下 载 页 面 和 英文 站 点 的 布局 

KADE, 中 文 站 点 只 提供 最 新 发 布 版 本 的 下 载 链 接 , 而 英文 站 点 同时 提供 最 新 稳定 版 本 和 最 
新 版 本 两 个 版 本 的 下 载 链接 。 


Node.js 的 其 他 发 布 版 本 可 以 从 https://nodejs.org/dist/ 找 到 ， 本 书 以 V10.9.0 Æ Windows 10 


进行 安装 为 例 进 行 介绍 。 


Node.js 的 安装 包 在 Windows 平台 分 为 installer 和 Binary 两 个 版 本 。installer 是 通常 的 安 
装 包 发 布 版 本 〈.msi) 。Binary 为 二 进 制版 本 ， 可 以 下 载 后 直接 运行 (.exe) 。 这 里 建议 使 用 
后 级 为 .msi 的 安装 版 本 。 此 外 ，Nodejjs 的 安装 包 分 为 32 位 和 64 位 ， 在 下 载 的 时 候 请 碍 看 系 
统 的 具体 信息 ， 并 选择 正确 的 安装 包 进 行 下 载 和 安装 。 

打开 Nodejs 官方 网 站 下 载 页 面 ， 如 图 2.1 所 示 。 读 者 可 根据 自己 的 系统 选择 ， 比 如 笔者 
的 电脑 是 64 位 的 Windows 系统 ， 下 载 的 是 node-v10.9.0-x64.msi。 


Node.js 10 ZiR 


) @ Download | Node.js x 


< © a 安全 | https/ nodejs.org/en/download/current/ 


Downloads 


Download the Node.js source code or a pre-built i MFOor your platform, and start developing today. 


LIS Current 


Recommended For Most Users Latest Features 


ae š 


Windows Installer macos Installer Source Code 


Windows Installer (.msi) 


Windows Binary (.zip) 


macQS Installer ({.nkg) 
gf/node-v10.90-x64.msi 


2.1 Node.js 官方 网 站 下 载 页 面 


如 果 选 择 Node.js 之 前 的 版 本 ， 可 以 在 官方 网 站 中 找到 Previous Releases 链接 ， 然 后 查找 
需要 的 版 本 号 。 


2.1.1 使 用 安装 包 安 六 Node.js 


(1) 安装 包 下 载 完 之 后 是 一 个 16MB 大 小 的 后 级 名 为 msi 的 安装 文件 ， 双 击 下 载 后 的 安 
装 包 文件 ， 育 移 弹 出 安装 同 寻 的 欢迎 界面 ， 如 图 2.2 所 示 。 


pS Node.js Setup 


Welcome to the Node.js Setup Wizard 


The Setup Wizard allows you to change the way Node.js 
features are installed on your computer or to remove it from 
your computer. Click Next to continue or Cancel to exit the 
Setup Wizard. 


图 2.2 欢迎 界面 
(2) 单 击 图 2.2 中 的 Next (下 一 步 ) 按钮 会 出 现 最 终 用 户 授权 协议 界面 ， 如 图 2.3 所 示 。 
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勾 选 接受 协议 选项 后 Next 按钮 会 变 为 可 用 状态 ， 单 击 Next 按钮 进入 下 一 步 。 


End-User License Agreement a 
Please read the following license agreement carefully a ~ © 


Node.js is licensed for use as follows: 

Copyright Node.js contributors. All rights reserved. 

Permission is hereby granted, free of charge, to any person obtaining 

a copy of this software and associated documentation files (the 
"Software"), to deal in the Software without restriction, including 

without limitation the rights to use, copy, modify, merge, publish, 
distribute, sublicense, and/or sell copies of the Software, and to 

permit persons to whom the Software is furnished to do so, subject v 


回 Iaccept the terms in the License Agreement 


23 最终 用 户 授权 协议 界面 


(3) 此 时 打开 Node.js， 默 认 安 装 目录 为 C:\Program Files\nodejs\, WB] 2.4 所 示 。 我 们 既 
可 以 通过 Change 按钮 修改 目录 ， 又 可 以 直接 单 击 Next 按钮 。 


Choose a custom location or dick Next to install, 


Install Node.js to: 


图 2.4 安装 目录 


(4) 单 击 Next 按钮 后 出 现 如 图 2.5 所 示 的 目 定义 安装 界面 ， 我 们 选择 默认 设置 即 可 。 单 
击 Next 按钮 后 会 出 现 一 个 准备 安装 界面 ， 单 击 界面 中 的 Install 按钮 。 
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Wh K 


Custom Setup 


Select the way you want features to be installed. nede 


Click the icons in the tree below to change the way features will be installed. 


[Bax J Next J ces | 


25 上 自 定义 安装 界面 


(5) 开始 安装 的 界面 如 图 2.6 所 示 。 安 装 需要 等 待 1 分 钟 左 右 ， 安 装 完成 后 出 现 完成 界 
面 ， 单 击 Finish 按钮 就 完成 安装 了 。 


Ë! Nodejs Setup 


Installing Node.js 


Please wait while the Setup Wizard installs Node.js. 


Status: Updating component registration 


26 ”开始 安装 


(6) 安装 后 ， 系 统 默认 的 环境 变量 PATH 是 C:\Documents and Settings\Administrator\ 
Application Datampm， 也 可 以 根据 需要 手动 修改 本 地 的 安装 目录 ， 并 将 全 局 目录 设置 为 与 本 地 
初始 默认 安装 目录 一 致 。 在 完成 安装 Node.js 的 时 候 ， 默 认 也 安装 了 NPM。NPM 是 Node.js 
的 包 管 理工 具 ， 在 后 面 的 章节 进行 介绍 。 


要 查看 PATH 变量 ， 需 要 右 击 计算 机 ， 选 择 “ 属 性 | 高 级 系统 属性 选项 打开 “系统 


属性 对 话 框 。 然 后 单 击 “ 高 级 | 环境 变量 ”选项 , 在 “用户 变 量 列表 项 中 找到 PATH 
变量 ， 单 击 下 方 的 “编辑 ”按钮 就 可 以 看 到 所 有 变量 在 这 里 的 设置 ， 主 要 是 设置 路 径 。 


24.2 Mit Node.js 开发 环境 
安装 Node.js 开发 环境 成 功 之 后 , 创建 一 个 简单 的 App 来 测试 Node.js 是 否 能 够 正常 运行 。 


第 2 章 部 署 Node.js 开发 环境 


首先 ， 为 App 创建 一 个 目录 ， 目 录 里 面 创 建 一 个 名 为 hello world.js 的 JS 文件 ， 然 后 在 
hello world js 中 写 入 如 下 代码 。 


【示例 2-1] 
var http = require('http'); 
http.createServer (function (request, response) { 
response.writeHead (200, ('Content-Type': 'text/plain')); 
response.end('Hello WorldNn'); 
}).listen (3000); 
console.log ('Server running at http://localhost:3000/'); 


【代码 说 明 】 

上 面 的 代码 是 一 个 简单 的 Nodejs Web 服务 举例 , 会 在 电脑 上 创建 一 个 HTTP Web 服务 ， 
并 在 网 页 上 打印 出 Hello World FFP. Mit Windows 开始 菜单 | Node.js | Node.js command 
prompt 来 运行 Node.js。Node.js command prompt 是 一 个 命令 行 界面 ， 用 来 启动 Node.js 编译 环 
境 。 如 果 在 开始 菜单 里 找 不 到 Node.js command prompt， 可 以 在 搜索 框 中 输入 node， 然 后 找到 
它 并 运行 。 

因为 默认 打开 的 路 径 不 是 我 们 创建 项 目的 路 径 ， 所 以 这 里 可 以 通过 cd 命令 来 切换 路 径 : 
EN IRF E i 


cd E:\WebstormProjects\NodejsDev\chpater02 # 切 换 到 项 目 路 径 


接 下 来 运行 hello world.js， 人 简单 地 输入 如 下 node 命令 : 


node hello world.js 


如 果 一 切 都 顺利 ， 那 么 我 们 将 会 在 command prompt 中 看 到 : 


Server running at http://localhost:3000/ 


界面 内 容 如 图 2.7 所 示 。 


Node.js command prompt - node hello_worldjs 


27 Node.js 命令 行 运行 界面 
然后 打开 浏览 器 输入 如 下 URL: 


http://localhost:3000/ 


接着 会 在 浏览 器 中 看 到 “Hello World”， 如 图 2.8 所 示 。 这 说 明 Node 平台 安装 成 功 ， 并 
且 能 成 功 运行 Node.js 程序 。 
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文件 (EF) 编辑 (E) EEV PEO 书签 和 外) ISM 


localhost:3000/ 
| 


Hello World 


28 Hello World 程序 运行 结果 


£. 在 Linux 下 部 署 Node.js 开发 环境 


在 Linux 下 安装 Nodejs 有 很 多 种 方法 ， 御 见 的 方法 有 通过 包 管 理 器 安装 和 源码 安装 。 下 
面 针对 各 种 版 本 的 Linux 和 安装 方法 进行 介绍 。 


2.2.1 通过 源码 安 闻 Node js 


下 面 以 Ubuntu 16.04 为 例 说 明 如 何 使 用 源码 安装 Node.js。 
(1) 通过 下 面 的 命令 安装 版 本 工具 。 


apt-get install make g++ libssl-dev git 


(2) 新 建 一 个 目录 ， 并 使 用 wget 命令 下 载 Nodejjs 源码 。 


cd /tmp 

wget http://nodejs.org/dist/v0.10.32/node-v10.9.0-linux-x64.tar.gz 
Ear xvi node vO 9 0 linux x64'Lar qz 

cd node v T10 510 


或 者 通过 git 命令 直接 从 GitHub 上 复制 。 


git clone https://github.com/joyent/node 


cd node 

(3) 配置 安装 选项 并 进行 编译 安装 ， 其 中 X 代表 服务 器 的 CPU 数量 。 
./configure 
make -jX 


make install 


安装 成 功 后 ， 可 以 使 用 node -v 命令 来 检查 Node.js 的 版 本 以 及 是 否 安装 成 功 。 


区 元 Node.js 选择 下 载 源 码 进 行 编译 安装 之 前 ， 要 确保 系统 安装 了 Python 2.6 或 3.5 (或 更 高 的 
| 版 本 ) 。 
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222 ”通过 包 管 理 器 安装 Node.js 

在 Linux 的 不 同 版 本 下 可 以 使 用 NPM 安装 Nodejs。 下面 仅 列 举 几 种 常见 的 安装 Linux 发 
布 版 的 方法 。 

1. Arch Linux 

在 Arch Linux 中 ，Nodejs 和 NPM 包 是 全 面 支持 的 ， 可 以 通过 一 条 指令 进行 安装 : 
pacman -S nodejs npm 

2 基于 Debian 和 Ubuntu 的 Linux 发 布 版 


基于 Debian 和 Ubuntu 的 Linux 发 布 版 主要 包括 Linux Mint、Linux Mint Debian Edition 
(LMDE) 和 elementaryOS， 可 以 通过 Debian 和 Ubuntu 的 社区 NodeSource 来 下 载 和 安装 ， 
在 GitHub 上 的 链接 地 址 是 https://github.com/nodesource/distributions。 需 要 注意 的 是 ， 通 过 
nodesource 安装 的 版 本 可 能 并 不 是 最 新 的 。 
© 安装 Node.js 10.x 版 本 的 方法 如 下 : 


curl -sL https://deb.nodesource.com/setup 10.x | sudo -E bash - 
sudo apt-get install -y nodejs 


3.Red Hat Enterprise Linux/RHEL, CentOS 和 Fedora 


在 Red Hat, CentOS 和 Fedora 上 使 用 NPM 安装 Node.js 的 时 候 需 要 修改 对 应 的 地 址 ， 具 
体 版 本 的 链接 可 能 略 有 不 同 。 要 使 用 root 用 户 登 录 ， 并 执行 下 面 的 命令 : 


© 4x 版 本 


curl --silent --location https://rpm.nodesource.com/setup 4.x | bash - 


© 6x 版 本 


curl --silent --location https://rpm.nodesource.com/setup 6.x | bash - 


© 10x 版 本 


curl --silent --location https://rpm.nodesource.com/setup 10.x | bash - 


然后 使 用 yum 命令 来 安装 Node.js: 


yum -y install nodejs 


在 Fedora 18 之 后 的 版 本 ，Nodejs 和 NPM 是 默认 支持 的 ， 只 需要 通过 下 面 的 一 条 命令 就 
可 以 安装 ; 


sudo yum install nodejs npm 
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在 Mac OS X 上 安装 有 3 种 方式 ， 即 使 用 源码 安装 、 使 用 NPM 包 管 理 器 安装 和 使 用 安装 
包 安 装 。 本 节 主 要 介绍 如 何 使 用 .dmg 安装 包 和 NPM 包 管 理 器 进行 安装 。 


2.3.1 使 用 .dmg 安装 包 进 行 安装 


首先 从 Node.js 官方 网 站 上 下 载 最 新 的 OS X 安装 包 ， 并 按照 安装 癌 导 进行 安装 ， 界 面 如 
图 2.9 所 示 。 


eo. @ Install Node a 


The installation was completed successfully. 


è Introduction Node was installed at 


è License /usr/local/bin/node 


è Destination Select š 
npm was installed at 

è Installation Type 

Se /usr/local/bin/npm 


è Summary Make sure that /usr/local/bin is in your $PATH. 


G 


29 在 OSX 下 安装 Node.js 


安装 之 后 ，/usr/local/bin 在 环境 变量 中 已 经 定义 ， 如 果 没 有 ， 融 在 当前 用 户 home 目录 下 
的 .bash profile 或 者 .bashrc 中 添加 。 


232 ”使 用 NPM 包 管 理 器 安装 
使 用 NMP 包 管 理 器 安装 Node.js 时 要 从 Node.js 的 官方 网 站 上 下 载 最 新 的 Macintosh 
Installer。 可 以 通过 curl 执行 下 面 的 命令 来 安装 : 


curl "https://nodejs.org/dist/latest/node-${VERSION:-$ (wget -qO- 
https://nodejs.org/dist/latest/ | sed -nE 

's| .*&>node-(.*)N.pkg</a>.*|N1|p')).pkg" > "$HOME/Downloads/node-latest.pkg" && 
sudo installer -store -pkg "$HOME/Downloads/node-latest.pkg" -target "/" 


或 者 使 用 MacPorts 执行 下 面 的 代码 : 


port install nodejs 
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在 树 莓 派 3 下 使 用 NVM 安装 Node.js 


树 春 派 是 一 和 亚 卡 片 式 的 学 习 电 脑 ， 由 英国 剑桥 大 学 在 2012 年 3 月 首发 。 本 节 主 要 介绍 如 
何在 树 莓 派 3 的 官方 操作 系统 Raspbian 上 使 用 NVM 安装 Node.js。 


(1) 下 载 和 安装 NVM (https://github.com/creationix/nvm) 。NVM 的 全 称 是 Node Version 
Manager (Node.js 版 本 管理 器 ) ， 它 可 以 让 我 们 在 各 个 Nodejjs 版 本 之 间 进 行 灵 活 的 切换 。 


git clone https://github.com/creationix/nvm.git ~/.nvm && cd ~/ .nvm && git checkout 
w 0) 25743 


(2) 使 用 nano 命令 编辑 .bashrc 和 .profile， 在 文件 末尾 增加 source ~/.nvm/nvm.sh, jf E 
新 启动 树 奏 派 ， 具 体 命 令 如 下 : 


sudo nano ~/.bashrc 
sudo nano ~/.profile 


sudo reboot 


(3) 局 动 完成 后 ， 在 shel 里 面 执行 nvm 命令 。 当 看 到 和 输出 时 ， 表 示 NVM 安装 成 功 。 


nym — version 

(4) 开始 安装 Node.js。 使 用 nvm 命令 安装 Node.js 稳定 版 ， 如 v8.11.4。 
$ nym installi 8-1174 

(5) 安装 完成 后 ， 可 以 使 用 下 面 的 代码 进行 查看 。 


$ nvm ls 


这 时 可 以 看 到 目 己 安装 的 所 有 Node.js 版 本 。 


使 用 NPM 进行 Node BWER 


前 面 我 们 已 经 使 用 很 多 次 NPM 命令 了 ， 这 其 实 使 用 的 是 Node.js 默认 的 包 管理 器 NPM. 
当 Node.js 安装 完成 后 ，NPM 也 默认 安装 完成 。 安 装 包 模 块 使 得 Node js 变 成 了 一 个 更 加 强大 
的 Web App 开发 平台 。 它 能 预先 为 Node.js App 提供 所 需要 的 功能 。NPM 官方 网 站 号 称 有 
250 000 个 不 同 的 包 可 供 开 发 者 下 载 使 用 ， 网 址 为 https://www.npmjs.com/。 

例如 ， 我 们 希望 在 Nodejs 上 扩展 一 个 MySQL 接口 ， 可 以 让 我 们 在 App 中 使 用 MySQL 
数据 库 ， 只 需要 在 Node.js command prompt 中 输入 如 下 命令 即 可 : 


npm install mysql 


上 面 的 命令 会 通过 NPM 下 载 和 安装 MySQL Node 包 。 当选 择 的 包 安 装 完成 时 会 看 到 如 图 
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2.10 所 示 的 信息 。 


EEN Node.js command prompt 一 口 x 


string_decoder@0. 10.31, isarray@0.0). 1, core-util-isQ@1.0.l 2) 


图 2.10 使 用 NPM fE Windows 下 安装 MySQL 包 
NPM 的 第 用 命令 介绍 如 下 。 
(1) 查看 帮助 
npm help 或 npm h 
(2) 安装 模块 
npm intstall <Module Name> 
(3) 在 全 局 环境 中 安装 模块 〈-g: 局 用 global 模式 ) 
npm install -g <Module Name> 
更 多 的 内 容 可 参考 https://npmjs.org/doc/install.html。 
(4) 凶 载 模块 
npm uninstall <Moudle Name> 
(5) 显示 当前 目录 下 安装 的 模块 


npm list 


n 
Node.js 安装 成 功 后 ， 系 统 会 自动 在 PATH 用 户 环境 变量 和 系统 环境 中 分 别 添 加 NPM 和 
Node.js 路 径 。 


Y 


开发 工具 介绍 


为 了 更 高 效 地 编写 Node.js 代码 ， 需 要 使 用 一 个 好 的 编辑 器 ， 这 里 推荐 大 家 使 用 Sublime 
Text. Sublime Text 是 一 蒜 具 有 代码 高 党 、 语 法 提示 、 目 动 完成 且 反 应 快速 的 编辑 器 软件 。 它 
主要 有 以 下 两 大 优点 。 

© 跨 平 台 Sublime Text 3 为 跨 平 台 编 辑 器 ， 可 以 在 Windows、MacOSX 和 Linux TF = 

装 。 开 发 人 员 在 开发 和 测试 的 时 候 切 换 系 统 是 常 有 的 事情 ， 为 了 减少 重复 学 习 ， 使 用 
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一 个 跨 平 台 的 编辑 器 是 很 有 必要 的 。Sublime Text 3 可 以 使 你 的 开发 工作 在 各 个 系统 
之 间 进 行 无 缝 切换。 
@ 可 扩展 : Sublime Text 3 包含 大 量 实用 插件 ， 可 以 通过 安装 自己 领域 的 插件 来 成 倍 提 
高 工作 效率 ， 
Sublime Text 有 Sublime Text 2 和 Sublime Text 3 两 个 版 本 。 它 们 的 界面 大 臻 相同， 但 是 
Sublime Text 3 的 局 动 速度 更 快 ， 而 且 文 持 更 多 的 功能 ， 所 以 本 书 以 Sublime Text 3 为 例 进 行 
介绍 。 


2.6.1 下 载 安 装 Sublime Text 3 


Sublime Text 3 beta 版 本 已 经 非常 稳定 了 ， 官 方 下 载 网 址 为 http://www.sublimetext.com/3 , 
需要 注意 的 是 Sublime Text 3 是 付费 软件 虽然 可 以 无 限期 地 进行 试用 , 但 是 如 果 是 长 期 使 用 ， 
建议 购买 正版 的 序列 号 激活 。 


(1) 打开 下 载 页 面 ， 如 图 2.11 所 示 。64 位 的 Windows 系统 请 选择 “Windows 64bit” 安 
装 包 , 即 下 载 文件 为 “Sublime Text Build 3176x64 Setup.exe” 的 安装 程序 。“portable version” 
下 载 下 来 为 “Sublime Text Build 3176 x64.zip” 编 辑 器 的 包 ， 解 压 后 无 须 安装 就 能 运行 。 


号 
j £ Download - Sublime Text x W A, 
y L “ 


< CÇ &8 =š | https/Avww.ublimetext.com/3 


Sublime Text 


Download Buy News Forum Support 


Download 


Sublime Text 3 is the current version of Sublime Text. For bleeding-edge releases, see the dev builds. 


Version: Build 3176 
o QS X(10.7 or later is required) 
o Windows - also available as a portable version 
* Windows 64 bit - also available as a portable version 
o Linuxrepos - also available as a 64 bit or 32 bit tarball 


Sublime Text may be downloaded and evaluated for free, however a license must be purchased for continued 


use. There is currently no enforced time limit for the evaluation. 


2.11 Sublime Text 3 官方 下 载 页 面 


(2) 双击 下 载 下 来 的 安装 包 ， 并 按照 提示 进行 安装 ， 如 图 2.12 所 示 。 
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jË] Setup - Sublime Text 3 一 x 


Welcome to the Sublime Text 3 
Setup Wizard 


This will install Sublime Text Build 3114 on your computer. 


It is recommended that you dose all other applications before 
continuing. 


Click Next to continue, or Cancel to exit Setup. 


2.12 Sublime Text 3 的 安装 过 程 


(3) 安装 成 功 后 ， 双 击 果 面 上 的 “Sublime Text 3” 快 捷 图 标 ， 就 可 以 打开 Sublime Text 3 
程序 了 。 


如 果 是 Mac OS X 或 者 Ubuntu 就 下 载 相应 的 安装 包 ， 并 参照 安装 说 明 进 行 操 作 。 如 果 是 


在 Linux 下 安装 ， 就 先 使 用 uname -m 命令 查看 操作 系统 的 类 型 ， 再 选择 合适 的 安装 包 。 


2.6.2 Sublime Text 操作 表面 
Sublime Text 3 的 操作 界面 如 图 2.13 所 示 。 


u 


Writing file /C/Users/Lucida/Desktop/Sublime Text 3 $ISR8S|.md with encoding UTF-8 (atomic) 
>>> 


>>> 
>> 控制 台 
>>> 


图 2.13 Sublime Text 3 的 操作 界面 
界面 中 的 各 种 操作 选项 说 明 如 下 。 


24 


第 2 章 部署 Node.js 开发 环境 


© 标签 (Tab) : 分 别 显示 每 个 打开 的 文件 。 

© 编辑 区 (Editing Area) : 编辑 文本 内 容 的 区 域 ， 位 于 界面 的 中 心 位 置 。 

© 侧 栏 (Side Bar) : 包含 当前 打开 的 文件 以 及 文件 夹 视图 。 

© “EÉ (Minimap): 当前 打开 文件 的 缩 略图 。 

© 命令 板 (Command Palette ) : Sublime Text 的 操作 中 心 ， 使 我 们 基本 可 以 脱离 鼠标 和 
菜单 栏 进行 操作 。 

© 控制 台 (Console): 使 用 Ctrl+ ` 快 捷 键 可 以 调 出 该 窗口 。 它 既是 一 个 标准 的 Python 


REPL， 又 可 以 直接 对 Sublime Text 进行 配置 。 
© 状态 栏 (Status Bar): 显示 当前 行 号 、 当 前 语言 和 Tab 格式 等 信息 。 


PD. Sublime Text 3 的 相关 操作 文档 和 使 用 说 明 在 https://www.sublimetext.com/docs/3/ 上 。 


2.6.3 安装 Sublime Text 3 插件 


Sublime Text 3 最 强大 的 功能 是 针对 各 种 开发 语言 的 编辑 插件 .为 了 安装 和 管理 这 些 插件 ， 
我 们 首先 需要 安装 包 管 理 器 (Package Control) ， 官 方 首 页 链接 为 https://packagecontrol.io。 通 
过 Ctrl+` 快 捷 键 或 者 在 菜单 中 选择 View | Show Console 来 打开 控制 台 , 然后 将 下 面 的 代码 粘贴 
到 控制 台中 运行 。 
import urllib.request,os,hashlib; h = '2915d1851351e5ee549c20394736b442' + 


'8bc59f460fa1548d1514676163dafc88"; pf = 'Package Control.sublime-package'; ipp 
—sublime.insralled packages path(}s 


urilib.request.install opener( urilib.request.build opener( urllib.request.Pro 
xyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + 
pt-replace(" 1; '%20")) read(); dh = hashlib.sha256 (by) -hexdigest () ; print ( "Error 
validating download (got %s instead of $s), please try manual install" % (dh, h)) 
if dh != h else open(os.path.join( ipp, pf), 'wb' ) .write (by) 


这 段 代 码 将 创建 一 个 安装 包 的 目录 ， 并 将 包 控制 器 Package Control.sublime-package 下 载 
到 这 个 目录 中 。 安 装 完毕 后 ， 需 要 重新 局 动 Sublime Text 3。 
264 安装 Node.js 插件 


在 Package Control 首页 的 搜索 框 中 输入 NODE， 就 可 以 查找 到 所 有 和 Node.js 相关 的 包 ， 
如 图 2.14 所 示 。 可 以 看 到 由 tanepiper 创建 的 Node.js 包 是 当下 最 热门 的 Node.js 插件 ， 下 载 量 
为 156 000 次 。 
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Package Control NODE 


SORTBY Relevance Popularity 


NodeEval by mediaupstream BA 3K 
A Sublime Text Plugin that "evals" a selection/document with NodeJS 


Nodejs by tanepiper, vap E # TOP 100 


nodejs snippets and bindings for Sublime Text 2 


NodeRequirer py ganemone 9K 
A Sublime Text 3 plugin for requiring modules 


nodejsLauncher by diestin BA 14K 
Launch the file with node.js. 


Node Completions by james2doyle 30K 
A collection of completetions/snippets for node.js v5.x 


JavaScript & Nodels Snippets by zenorocha 82K 
JavaScript & NodeJS Snippets for Sublime Text 2/3 


o Node Framework py justindooo [CI 1K 
Vo Node Sublime 


图 2.14 Package Control 包 搜 索 和 下 载 页 面 


打开 Node.js 包 的 链接 ， 我 们 可 以 看 到 这 个 包 的 详细 介绍 和 使 用 方法 ， 并 且 可 以 查看 到 这 
个 包 每 月 的 下 载 量 。 
@ 在 MaCOSX 下 的 安装 命令 : 


`git clone https://github.com/tanepiper/SublimeText-Node.js.git 
~/Library/Application\ Support/SublimeN Text\ 3/Packages/Node.js` 


© 在 Windows 下 的 安装 命令 : 


`git clone https://github.com/tanepiper/SublimeText-Node.js "%APPDATA%\Sublime 
Text 3NPackagesNNode. js" ` 


© 在 Linux 下 的 安装 命令 : 


‘git clone https://github.com/tanepiper/SublimeText-Node.js 
SHOME/ .config/sublime-text-3/Packages/Node.js` 


2.6.5 Sublime Text 3 快捷 键 

按照 类 型 可 以 把 快捷 键 分 为 编辑 、 选 择 、 查 找 和 蔡 换 、 跳 转 、 窗 口 、 屏 幕 。 这 里 分 别 对 各 
用 的 快捷 键 做 一 个 简单 介绍 。 

1. 编辑 

© Ctrl+Enter: 在 当前 行 下 面 新 增 一 行 ， 然 后 跳 至 该 行 。 

@ Ctri+ShiftrEnter: 在 当前 行 上 面 增 加 一 行 并 跳 至 该 行 。 

© Ctrl+ 一 /一 : 进行 逐 词 移动 。 

© Ctrl+Shift+ 一 /一 : 进行 逐 词 选 择 。 
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Ctrlt+ t/t: 移动 当前 显示 区 域 。 
Ctrl+Shif 1 / 1: 移动 当前 行 。 


选择 


Ctrl+D: 选择 当前 光标 所 在 的 词 并 高 亮 显 示 该 词 所 有 出 现 的 位 置 ， 再 次 按 CtrltD 快 
捷 键 选择 该 词 出 现 的 下 一 个 位 置 。 在 多 重 选 词 的 过 程 中 ， 使 用 Ctrl+K 快捷 键 进行 跳 
过 ， 使 用 CtrlHU 快捷 键 进行 回 退 ， 使 用 Esc 键 退出 多 重 编辑 。 
Ctrl+Shift+L: 将 当前 选中 区 域 打 散 。 

Ctrl+J: 把 当前 选中 区 域 合并 为 一 行 。 

Ctrl+M: 在 起 始 括号 和 结尾 括号 间 切 换 。 

Ctrl+Shift+M: 快速 选择 括号 间 的 内 容 。 

Ctrl+Shift+J: 快速 选择 同 缩 进 的 内 容 。 

Ctrl+Shift+Space: 快速 选择 当前 作用 域 (Scope) 的 内 容 。 


查找 和 蔡 换 


F3: 跳 至 当前 关键 字 下 一 个 位 置 。 

Shift+F3: 跳 到 当前 关键 字 上 一 个 位 置 。 

Alt+F3: 选中 当前 关键 字 出 现 的 所 有 位 置 。 
Ctrl+F/H: 进行 标准 查找 /替换 ， 之 后 : 

> AltHC: 切换 大 小 写 敏感 ( Case-Sensitive ) 模式 。 
> AlttW: 切换 整 字 匹配 ( Whole Matching ) 模式 。 
> Alt+R: 切换 正则 匹配 (Regex Matching ) 模式 。 
Ctrl+Shift+H: 替换 当前 关键 字 。 

Ctrl+Alt+Enter: 替换 所 有 关键 字 匹 配 。 
Ctrl+Shift+F: 多 文件 搜索 和 替换 。 


跳 转 


Ctrl+P: 跳 转 到 指定 文件 ， 输 入 文件 名 后 可 以 再 输入 以 下 内 容 。 

> @ 符 号 : 跳 转 输入 ， 如 @symbol 跳 转 到 symbol 符号 所 在 的 位 置 。 
> # 关 键 字 : 跳 转 输入 ， 如 考 eyword 跳 转 到 keyword 所 在 的 位 置 。 
> : 行 号 : 跳 转 输 入 ， 如 :12 跳 转 到 文件 的 第 12 行 。 

Ctrl+R: 跳 转 到 指定 符号 。 

Ctrl+G: 跳 转 到 指定 行 号 。 


窗口 


Ctrl+ShiftHN: 创建 一 个 新 窗口 。 
CtrlHN: 在 当前 窗口 创建 一 个 新 标签 。 
Ctrl+W: 关闭 当前 标签 ， 当 窗口 内 没有 标签 时 会 关闭 该 窗口 。 
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@ CtrirShift+T: 恢复 刚刚 关闭 的 标签 。 
6. 屏幕 


F11: 切换 至 普通 全 屏 。 
Shift+F11: 切换 至 无 干扰 全 屏 。 
Alt+Shift+1Single: 切换 至 独 屏 。 
Alt+Shift+2Columns:2: 切换 至 纵向 二 栏 分 屏 。 
Alt+Shift+3Columns:3: 切换 至 纵向 三 栏 分 屏 。 
Alt+Shift+4Columns:4: 切换 至 纵向 四 栏 分 屏 . 
Alt+Shift+8Rows:2: 切换 至 横向 二 栏 分 屏 。 
Alt+Shift+9Rows:3: 切换 至 横向 三 栏 分 屏 。 
Alt+Shift+5: Grid 切换 至 四 格式 分 屏 . 


> 
名 o A 
£ g +E 
m o g 0 


学 完 本 章 后 ， 读 者 需要 回答 : 


1. 在 Windows 10 下 安装 Node.js 有 哪 几 种 方式 ? 

2. 如 何 使 用 NPM 下 载 特定 的 Node.js FRE? 

3. Node.js 在 Windows 中 的 默认 安装 路 径 是 什么 ? 

4. 在 Sublime Text 3 中 使 用 什么 快捷 键 可 以 新 建 一 个 文档 ? 
5. Node.js 文 持 哪些 操作 系统 ? 


Node.js 是 建立 在 V8 引擎 之 上 的 ， 也 就 意味 着 Node.js 的 语法 几乎 与 JavaScript 一 致 。 这 
也 是 Nodejjs 大 受 前 端 开 发 人 员 欢 迎 的 原因 ， 即 通过 一 门 语言 便 可 打通 前 后 端 开发 。 在 这 一 章 
中 将 介绍 JavaScript 的 基本 使 用 ， 为 之 后 Node.js 的 学 习 提供 必要 的 基础 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


© JavaScript 的 基础 语法 与 使 用 。 
@ 了 解 简单 的 JavaScript 编程 风格 。 
e 了 解 基 本 的 Node.js 控制 台 的 使 用 。 


3 ° ] JavaScript 语法 


JavaScript 是 一 门 直译 式 、 弱 类 型 的 脚本 语言 也 是 Web 开发 最 重要 的 语言 之 一 JavaScript 
由 ECMAScript DOM (文档 对 象 模型 ) 、BOM (浏览 器 对 象 模 型 ) 三 部 分 组 成 。ECMAScript 
规定 了 JavaScript 的 语法 核心 ， 这 也 是 本 节 重 点 介绍 的 内 容 。 


3.1.1 变量 


1. 交互 式 运 行 环境 一 一 REPL 

Nodejs 提供 了 一 个 交互 式 运 行 环境 一 一 REPL。 在 这 个 交互 式 环境 中 可 以 运行 简单 的 应 用 程 
序 。 在 控制 台 直 接 输 入 node 命令 即 可 进入 这 个 环境 ， 此 时 控制 台 会 显示 一 个 “>” 符 号， 表明 我 
们 已 经 进入 这 个 环境 ， 然 后 就 可 以 直接 在 命令 行 输入 node 代码 并 执行 了 ， 如 图 3.1 所 示 。 


3.1 进入 REPL 运行 环境 


Node js 10 Zik 


如 果 要 退出 该 运行 环境 ， 连 续 按 两 次 CtrlHC 快捷 键 ， 或 者 输入 .exit。Nodejs 的 命令 需要 
在 前 面 加 点 。 例 如 ， 可 用 .help 查看 所 有 命令 。 


本 节 中 的 所 有 代码 都 会 在 这 个 环境 中 使 用 和 运行 。 
2. 浏览 器 环境 一 一 Chrome & FireFox 


当然 ， 读 者 也 可 以 在 浏览 器 (Chrome & FireFox) 的 控制 台 运行 。 以 Chrome 浏览 器 为 例 

(FireFox 浏览 器 与 之 大 同 小 异 ), 通过 使 用 F12 键 或 者 Ctrl + Shift +I 快 捷 键 打开 开发 者 工具 ， 

在 开发 者 工具 栏 中 选择 Console 面板 ， 在 Console 中 也 是 显示 一 个 “>” 符 号 ， 和 REPL 的 使 
用 方法 一 致 ， 如 图 3.2 所 示 。 


[k á] Elements Console Sources Network Timeline Profiles Application Securi ty Audits 


Ñ Y top 


> 


32 浏览 器 的 Console 面板 


3. 关键 字 var 


JavaScript 的 变量 通过 关键 字 var 来 声明 。 前 面 说 过 JavaScript 是 一 门 弱 类 型 的 编程 语言 ， 
JavaScript 的 所 有 数据 类 型 都 可 以 用 var 关键 字 来 声明 ， 通 过 “var 变量 名 = 值 ” 的 形式 就 可 以 
对 变量 同时 进行 声明 和 赋值 。 和 许多 语言 一 样 ，JavaScript 通过 分 号 “:;” 来 分 隔 不 同 的 语句 ， 
以 下 这 段 代码 就 声明 了 两 个 变量 : 
var a — node Ts 


var b = 10; 
4. 变量 的 命 
JavaScript 规定 变量 名 必须 以 字母 、 美 元 符 ($)、 下 划 线 ( ) 三 者 之 一 开头 , 同时 JavaScript 


对 大 小 写 敏感 ， 大 小 写 不 同 也 就 意味 看 是 不 同 的 两 个 变量 。 同 时 ，JavaScript 不 区 分 单 引 号 与 
双 引 号 ， 因 此 上 一 个 例子 与 用 单 引 号 表示 的 效果 一 致 : 


var a = 'node.js'; 
var b = 10; 
5. 变量 提升 机 制 


JavaScript 中 存在 变量 提升 机 制 ， 也 就 是 所 有 的 变量 声明 在 运行 时 都 会 提升 到 代码 的 最 前 
方 。 例 如， 上 个 例子 在 运行 时 实际 上 会 先 声明 两 个 变量 再 赋值 : 


Var ay 


Nar Dr 
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a = "node.js"; 
[e == LJ 

通过 一 个 更 直观 的 例子 或 许 会 让 读者 更 容易 理解 变量 提升 .在 REPL 中 试图 使 用 一 个 未 声 
明 的 变量 时 会 出 现 is not defined 错误 ， 如 图 3.3 所 示 。 


33 ”变量 未 声明 错误 


如 果 试 图 使 用 一 个 已 经 声明 却 未 赋值 的 变量 ， 那 么 这 个 变量 所 代表 的 是 undefined, HHE 
3.4 所 示 。 


3.4 已 经 声明 却 未 赋值 


总 是 会 输出 一 


3.5 先 使 用 后 声明 赋值 
可 以 发 现 这 段 代 码 返 回 undefined 正 是 因为 变量 提升 ， 实 际 运行 的 代码 如 下 : 


var arf 


console.log (a); 
Se 
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3.1.2 注释 


JavaScript 中 的 注释 和 很 多 其 他 编程 语言 类 似 ， 以 双 斜 枉 〈/) 代表 单行 注释 ， 以 “/* 注 释 
内 容 */” 形 式 代 表 多 行 注释 。 
// 这 是 单行 注释 
/* 这 是 
多 行 
注释 
"f 


3.1.3 数据 类 型 


JavaScript 中 的 数据 类 型 可 以 分 为 简单 数据 类 型 和 复杂 数据 类 型 。 简 单数 据 类 型 有 
undefined, boolean. number. string, null, # 28329 482S339 HA object. object 由 一 组 无 序 的 键 
值 对 组 成 。 


1. 利用 typeof 区 分 数据 类 型 


利用 操作 符 typeof 可 以 区 分 数据 类 型 。typeof 返回 的 值 有 undefined, boolean. number, 
string, object 和 function。 下 面 举 一 个 例子 。 


【示例 3-1] 
var a; 
= 15 

= 'node.js'; 


true; 


< 
D 
H 
me 
II 


= function() I{ 


varir i= NUTS 


var = í 
num: 12 
} 
var arr [A pic d er tiq]; 
for (var i = 0, max = arr.length; i < max; itt) [Í 


console- tog(LypeoE Ərr| +] ); 


// undefined 
// number 

Iil String 

// boolean 
// function 


// object 
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// object 


【代码 解析 】 
可 以 看 到 null 和 object 都 返回 了 object， 这 是 因为 null 实际 上 是 一 个 空 对 象 指针 ， 当 一 个 
变量 只 声明 未 赋值 时 返回 undefined。 
number 和 string 数据 类 型 分 别 指数 字 类 型 和 字符 串 类 型 ; boolean 类 型 和 其 他 语言 一 样 ， 
ILA true 和 false 两 个 值 ， null 仅 有 一 个 值 null。 


2. 利用 Boolean() 转 化 数据 类 型 


JavaScript 中 可 以 利用 Boolean0 方 法 将 其 他 数据 类 型 转化 为 布尔 值 。 需 要 注意 的 是 ， 空 字 
符 串 、0、null、undefined、NaN 都 将 转化 为 false， 其 他 值 则 会 转化 为 tue。 下 面 举 一 个 例子 。 


【示例 3-2] 


-nl 


a; 
b 
var c = 0; 
d 
e 


var ZUNE 

var = NaN; 

war arr [La DC Ge > 

for (var i = 0, max = arr.length; i < max; i++) { 


console.log (Boolean (arr[i])); 


} 


// false 
// false 
// false 
// false 
// false 


3.1.4 AŽ 


在 JavaScript 中 ， 声 明 一 个 图 数 只 需要 使 用 function 关键 字 即 可 ， 如 声明 一 个 求 和 的 函数 ， 
代码 如 下 : 


function add (rumi p rum2)m dl 
return numi F num2; 


} 
当然 ， 函 数 同样 可 以 作为 一 个 值 传递 给 一 个 变量 ， 例 如 : 


var add = function(numl mnum2) I 
return numi F rum2; 


} 
调用 一 个 函数 同样 很 简单 ,只 需要 在 函数 声明 之 后 使 用 “函数 名 (参数 ) ”的 形式 调用 即 可 ， 
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如 调用 上 面 的 函数 : 


function addinumi; numz2) rl 
return numi t num2s 

} 

addi l T 2i 

i 3 


add (3,5); 
FB 


图 数 中 默认 带 有 一 个 arguments 对 象 ， 这 是 一 个 类 数组 对 象 。arguments WK / REZA PR 
数 的 参数 信息 , 因为 JavaScript 中 的 函数 调用 时 , 参数 个 数 并 不 需要 和 定义 图 数 时 的 个 数 一 致 。 
在 上 和 面 的 add0 方 法 中 多 添加 几 个 参数 ， 函 数 仍 然 会 正常 执行 ， 例 如 : 


Function acid numl num2) "1 
return numi F om 人 > 


) 
add(1,2,4,5,5); 
Fi 


add (3, r 2, 3) F 
//8 


利用 好 这 一 点 和 arguments 类 数组 的 特性 可 以 对 上 述 的 add 方法 拓展 一 下 ， 让 这 个 函数 无 
论 接收 多 少 个 参数 ， 总 能 返回 这 些 数 值 的 和 : 
function adda) TT 
var sum = 0; 
for (var i = 0, max = arguments.length; i < max; i++) { 
sum += arguments[i]; 
} 


SU 


} 


add (2,3,4); 
I9 


add {2, 4,5); 
Ir 11 


还 可 以 利用 JavaScript 中 的 arguments 类 数组 对 象 模拟 函数 重 载 。 当 然 ,， 实际 上 JavaScript 
并 不 支持 函数 重 载 ， 比 如 通过 检测 arguments 对 象 的 length 属性 做 出 不 同 的 反应 来 模拟 重 载 。 
下 面 给 出 一 个 完整 的 例子 。 
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【示例 3-3] 
function operate () { 

if (arguments.length == 2) { 
return arguments[0] * arguments[1]; 

} else { 
Meir Simi 07 
for (var i = 0, max = arguments.length; i < max; i++) { 

sum += arguments[i]; 

} 


return sum; 


} 

operate (3, 4); 
ZF 12 

operate (3, 4, 5); 
o E V 


以 上 代码 的 运行 效果 如 图 3.6 所 示 。 


Nodejs command prompt - node 


36 ”运行 效果 


【代码 解析 】 
arguments 对 象 是 一 个 类 数组 对 象 ,通过 数组 的 slice0 方 法 可 以 把 arguments 对 象 转化 为 一 
个 真正 的 数组 ， 这 样 就 可 以 使 用 数组 的 所 有 方法 ， 而 不 用 担心 出 现 其 他 问题 了 。 


function funName() { 
var arguments = [].slice.call (arguments); 


.the code oF Function 


} 


3.1.5 HE 
JavaScript 中 的 变量 可 以 分 为 全 局 变量 和 局 部 变量 。JavaScript 中 的 函数 自然 可 以 读 取 到 全 
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局 变量 ， 而 函数 外 部 并 不 能 读 取 到 函数 内 部 定义 的 变量 ， 例 如 : 


var str = 'node_ js"; 


Eunetan eopv (yy 
var Str2 = str; 
console. log(str2):; 


} 


copy () ; 
// mode.js 


console.log(str2); 


M S seErolisifnotprideErneco 


当然 ， 这 需要 在 定义 变量 的 时 候 使 用 var 关键 字 定 义 。 不 用 var 关键 字 定 义 的 话 ， 实 际 上 
这 个 变量 会 成 为 全 局 对 象 的 一 个 属性 。 在 Node.js 中 ， 全 局 对 象 是 global， 如 果 上 面 代码 中 的 
str2 变量 不 使 用 var 定义 ，str2 就 会 成 为 一 个 全 局 变量 ,函数 外 部 也 是 可 以 读 取 到 这 个 变量 的 ， 
例如 : 


var str = ede js"; 


funetion copy N ri 
SE 和 =- SEr: 
console. log (str2}); 


} 


copy () ; 
// mode.js 


console  looqg(sStr2); 


// mode.js 


2 建议 所 有 的 变量 都 使 用 var 关键 字 进 行 定义 ， 以 避免 出 现 不 必要 的 错误 。 


JavaScript 中 的 闭 包 可 以 让 函数 读 取 到 其 他 函数 内 部 的 变量 ， 如 下 代码 就 可 以 让 函数 外 部 
读 取 到 函数 内 部 定义 的 变量 ， 这 就 是 最 简单 的 闭 包 。 


【示例 3-4】 
function a() [Í 
vac Seri "node gs; 
return Eririe t or () Ë 1 
yar str? Str FiIS poserful"; 


return str2; 
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} 


a() (); 


// mode.js is powerful 


以 上 就 是 JavaScript 的 简要 介绍 。 更 多 关于 JavaScript 的 知识 ， 读 者 可 以 阅读 相关 的 书籍 
进行 学 习 和 掌握 。 进 行 Node.js 的 学 习 之 前 ， 读 者 应 该 对 JavaScript 有 一 定 的 了 解 。 


eA 他 名 规范 与 编程 规 沁 
与 其 他 语言 相 比 ，JavaScript 显得 相对 灵活 ， 对 代码 的 格式 要 求 也 相对 宽松 ， 因 此 对 


JavaScript 编码 制定 一 定 的 规范 是 非常 重要 的 。 一 个 良好 的 规范 不 仅 能 让 阅读 代码 的 人 感到 清 
晰 愉 饮 ， 还 能 让 整个 项 目 更 加 容易 维护 。 


3.2.1 命名 规范 

JavaScript 作为 一 种 弱 类 型 的 语言 ， 命 名 的 规范 显得 更 加 重要 ， 因 为 开发 人 员 并 不 能 直接 
看 出 这 个 变量 的 作用 。 

1. var 关键 字 

在 JavaScript 中 ， 所 有 的 变量 都 应 该 通过 var 关键 字 来 定义 ， 而 不 是 缺少 var 关键 字 ， 因 
为 缺少 var 的 变量 声明 会 使 得 这 个 变量 成 为 全 局 变量 ， 在 开发 中 应 尽量 减少 全 局 变量 : 
var a = 'node.js'; 
// 推荐 
b = 12 
// 不 推荐 

2. 驼峰 命名 法 

在 开发 中 , 变量 的 命名 常常 是 让 开发 人 员 头 疼 的 问题 , 一 般 来 说 每 个 团队 都 会 有 自己 的 命 
名 规范 。 近 些 年 来 更 加 流行 的 是 驼峰 命名 法 。 如 它 的 名 字 一 样 ， 驼 峰 命 名 法 中 第 一 个 单词 的 开 
头 小 写 ， 其 他 单词 的 开头 字符 大 写 ， 例 如 : 
var myNumber; 


var myString; 

3. 常量 

在 其 他 语言 中 ， 会 有 向 量 这 样 一 个 概念 。 这 是 一 种 不 允许 在 声明 赋值 之 后 再 修改 的 变量 。 
显然 ，JavaScript 中 有 着 同样 的 需求 。 在 开发 人 员 不 希望 有 些 变量 得 到 修改 时 ， 常 量 就 显得 格 
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外 重要 了 。 例 如 ， 定 义 一 个 圆周 率 的 常量 。 

在 第 量 的 命名 中 ， 开 发 人 员 往 往 采 用 变量 名 全 部 大 与 的 方式 来 表示 这 是 一 个 第 量 。 当 然 ， 
实际 上 这 样 的 变量 依旧 是 可 以 被 修改 的 。 这 需要 开发 人 员 共同 遵守 规定 , 把 这 样 一 个 变量 作为 
一 个 常量 ， 而 不 是 普通 的 JavaScript 变量 : 
var PI = 3.14159 
// 这 是 一 个 圆周 率 的 常量 


4. 内 部 变量 


开发 中 还 有 一 类 惑 是 内 部 变量 这 类 变量 并 不 硕 望 局 部 作用 域 之 外 的 作用 域 来 获取 这 些 变 
E. FRANKKA PRR “ ”开头 命名 作为 约定 俗 成 的 内 部 变量 。 当 然 ， 这 同样 需要 协同 
的 开发 人 员 共 同 遵 守 这 个 约定 : 
var obj ={ 

mum: 12, 

// 这 是 一 个 内 部 变量 

pūt: function) | 

return this mimi; 
} 


} 
console: log (obj -put ()) 


5. 有 意义 的 名 字 

命名 规范 中 同样 需要 遵守 的 是 , 在 命名 中 不 应 该 使 用 一 些 无 意义 的 变量 名 。 这 些 无 意义 的 
变量 名 往往 会 使 开发 人 员 摸 不 着 头脑 。 变 量 的 命名 应 该 是 有 意义 的 、 能 够 表示 变量 作用 的 ， 而 
不 是 无 意义 的 、 混 淆 视听 的 。 
3.2.2 ”编程 规范 


在 JavaScript 中 ， 章 守 编 程 规范 会 使 得 整个 项 目 得 到 更 快 的 开发 和 更 好 的 维护 。 同 时 ， 也 
可 以 让 代码 看 起 来 更 加 优雅 易 读 。 


1. 以 分 号 结尾 
在 JavaScript 代码 中 , 所 有 的 语句 都 应 该 以 分 号 结尾 ， 虽 然 JavaScript 中 并 没有 强制 要 求 : 


var n = 12; 
// 以 分 号 结尾 ， 推 荐 
var n = 12 


// 结尾 缺少 分 号 ， 不 推荐 
2. 大 括号 
JavaScript 4E2D 的 所 有 语句 块 都 应 该 有 大 括号 ， 比 如 一 个 简单 的 站 判断 语句 块 里 面 只 有 
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RT ERER 


一 行 时 ， 不 使 用 大 括号 并 不 会 出 现 错误 ， 但 是 这 往往 会 让 开发 人 
var n = 12; 
TEDES | 

console.log(n); 


) 
// 即使 语句 块 里 只 有 一 行 代码 ， 也 应 该 有 大 括号 


相等 判断 中 应 该 尽量 使 用 绝对 等 于 “==”， 因 为 等 于 “一 ”存在 类 型 转化 ， 这 在 开发 中 
可 能 会 出 现 意 想不到 的 错误 。 例如 , 使 用 “==” 来 判断 null 与 undefined 时 会 出 现 true 的 情况 ， 
而 使 用 “=” 则 不 会 : 


console.log(1 == true); 

// true 

Eonsolemlog(l i e); 

// false 

console.log (null == undefined); 
// true 

console.log (nu1l1 === undefined); 
// false 


4. 空格 的 使 用 


天 于 JavaScript 中 的 空格 ， 永 远 不 要 音 亩 ， 因 为 满 屏 连续 的 字符 串 会 让 人 头疼 。 建 议 在 数 
值 操 作 符 (如 +、-、*、/、% 等 ) 前 后 留 一 个 空格 ， 在 赋值 操作 符 和 相等 判断 中 前 后 留 一 个 空 
格 。 在 json 对 象 中 ， 键 值 对 的 冒号 后 应 该 留 一 个 空格 ， 如 以 下 空格 会 让 代码 在 开发 人 员 的 眼 
中 更 加 优雅 : 


Var num = 12; 
// 赋值 操作 符 前 后 留 空格 
if (num === 12) { 

// your coding 
} 
// 相等 判断 中 前 后 留 出 空格 
Var num2 = num * 2; 
// 数值 操作 符 前 后 留 出 空格 
var obj = { 

name: 'node.js' 
} 
// 键 值 对 冒号 后 面 留 出 一 个 空格 


Ë 元 关于 JavaScript 中 的 注释 ， 永远 记 住 一 条 : PCH 03 tab k S X 0. AXIER 
| 只 会 让 阅读 代码 的 人 员 感 到 更 加 困惑 。 
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关于 JavaScript 中 的 编程 规范 就 简单 介绍 到 这 里 。 相 比 于 别人 介绍 的 规范 ， 拥 有 一 套 属于 
自己 团队 内 部 的 使 用 规范 并 且 让 开发 人 员 遵 守 这 个 规范 更 加 重要 。 


3 3 Node.js 的 控制 台 


利用 好 Node.js 提供 的 控制 台 和 Debug 可 以 有 效 地 辅助 开发 和 定位 Bug. fE Node.js 中 ， 
Console 代表 控制 台 ， 可 以 通过 console 对 象 的 各 种 方法 同 控制 台 进 行 标准 输出 。 
3.3.1 console 对 象 下 的 各 种 方法 


在 REPL 交互 式 运 行 环境 中 输入 console, 可 以 看 到 console 对 象 下 各 种 方法 组 成 的 一 个 数 
组 ， 如 图 3.7 所 示 。 


EEN Node.js command prompt - node 


图 3.7 console 对象 的 方法 


3.3.2 console.log() 方 法 

console.log() 方 法 用 于 标准 输出 流 的 输出 ， 也 就 是 在 控制 台中 显示 一 行 信息 ， 例 如 : 
console.log ('node.js is powerful') 

无 论 是 在 RPEL 环境 中 运行 这 行 代 码 还 是 作为 Node.js 文件 执行 这 行 代码 ， 都 可 以 看 到 控 
制 台 输出 了 “node.js is powerful” 字 样 。 

console.log() 方 法 并 没有 对 参数 的 个 数 进 行 限制 ， 当 传递 多 个 参数 时 ， 控 制 台 输出 时 将 以 
空格 分 隅 这 些 参 数 ， 例 如 ; 
console "og: nodes r isu powerFul" h); 

运行 之 后 ， 同 样 会 在 控制 台 输出 “node.js is powerful” 字 样 ， 这 三 个 单词 依旧 是 以 空格 分 
陋 开 来 的 。 
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console.log() 方 法 也 可 以 利用 占 位 符 来 定义 输出 的 格式 ， 如 %d 表示 数字 、%s 表示 字符 串 。 


ET 如 果 需 要 对 后 面 的 多 个 参数 定义 格式 ， 就 要 逐个 设置 ， 并 且 输 出 时 将 不 会 再 以 空格 分 隔 ; 


如 果 没有 预定 义 格 式 ， 就 将 正常 输出 。 


示例 代码 如 下 : 
console log (t Ss node jsir IS. M BOWwSER Ys 


// node.jsis powerful 


console- log( ss Ss rr 'node:jJs'; ls "Powertul )s 


// node.jsispowerful 


console.: log( Sa "node js"); 


// NaN 


console sleog( sd "node js"; "is", PDOowertygl )s 


// NaN is powerul 

在 这 一 段 代码 中 ， 需 要 注意 的 是 当 使 用 %d 占 位 符 后 ， 如 果 对 应 的 参数 不 是 数字 ， 控 制 台 
将 会 输出 NaN。 
3.3.3 console.info()、console.warn() 和 console.error() 方 法 


console.info()、console.warn() 以 及 console.errorO 的 使 用 方法 和 console.log0 一 致 ， 将 3.3.2 
小 节 的 代码 换 成 console.info()、console.warn()、console.error(0 方 法 ， 将 得 到 同样 的 结果 : 


Conseleewarni ssss” rr "node. js", "is", 'powerful"'); 
// node.jsis powerful 


Sonsole-warn( SSS5 7r nodejs; “Iisi; F "'powertu"); 
// node.jsispowerful 


Console. inio sa T node oy 
// NaN 


console inito sd modem ys" 1S 0 T DOwerEEul ys 
// NaN is powerul 


consolecerror( Sd nodes js); 
// NaN 


console error (tdi; "nodejs; "1S1; 'powerful"') i 
// NaN is powerul 


43 


Node.js 10 实战 


3.3.4 console.dir() 方 法 
console.dir(0 方 法 用 于 将 一 个 对 象 的 信息 输出 到 控制 台 。 如 下 代码 将 定义 一 个 简单 的 对 象 。 


【示例 3-5] 
const obj = { 


name: 'node.js', 

get: function) I 
console.log ('get'!'); 

Fi 

set: Fimctrionm() PÍ 
console.log('set'); 

j 

} 


console.dir (obj); 


在 RPEL 交互 运行 环境 中 运行 这 段 代 码 ， 可 以 看 到 控制 台 输出 了 这 个 对 象 的 信息 ， 如 图 
3.8 所 示 。 


图 3.8 ”console.dir0 方 法 输出 对 象 信息 


3.3.5 ”console.time() 和 console.timeEnd() 方 法 


console.time() 和 console.timeEnd0) 方 法 主要 用 于 统计 一 段 代 码 运 行 的 时 间 。console.time0 方 
法 置 于 代码 起 始 处 ，console.timeEnd0 方 法 置 于 代码 结尾 处 。 只 需要 同 这 两 个 方法 传递 同一 个 
参数 , 就 可 以 看 到 在 控制 台中 输入 了 以 毫秒 计 的 代码 运行 时 间 。 如 下 代码 统计 了 两 个 循环 执行 
后 的 时 间 以 及 各 个 循环 分 别 使 用 的 时 间 。 


【示例 3-6] 


console time EoEal time"); 


console.time('timel'); 
for(var Or < T0000 ET 


} 
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console.timeEnd('time1'); 


console.time('time2'); 
Eor (var it Oris TOQ000:Ppirryni 


} 


console.timeEnd ('time2'!); 


console.timeEnd('total time'); 


将 这 段 代码 保存 为 名 为 time.js 的 文件 。 利 用 node time.js 命令 运行 这 个 文件 ， 可 以 在 控制 
台 看 到 各 个 循环 的 使 用 时 间 统 计 ， 如 图 3.9 所 示 。 


图 3.9 各 个 循环 的 使 用 时 间 统 计 


3.3.6 ”console.trace() 方 法 


console.trace0 方 法 用 于 输出 当前 位 置 的 栈 信息 ， 可 以 问 console.trace() 方 法 传递 任意 字符 
串 作为 标志 ， 类 似 于 console.time0 中 的 参数 。 在 RPEL 交互 运行 环境 中 执行 以 下 代码 : 


console.trace (‘trace’);) 


可 以 看 到 此 处 的 栈 信息 已 经 在 控制 台中 输出 了 ， 如 图 3.10 所 示 。 


图 3.10 ”console.trace0 输 出 栈 信 息 


3.37 console.table() 方 法 


console.table() 用 于 将 数组 格式 的 信息 以 表格 (table) 形式 进行 输出 ， 可 以 同 console.table() 
方法 传递 任意 结构 形式 的 数组 信息 ， 壁 如 对 象 数组 等 。console.table0) 方 法 在 RPEL 交互 运行 环 
境 中 执行 以 下 代码 : 


console.table (tabularData[, properties]); 
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如 下 代码 使 用 console.table0 方 法 将 一 个 对 象 数 组 以 表格 的 形式 进行 输出 。 
【示例 3-7】 


var arrTable = { 
A: Ino <: "Im name : “Applerl 
B: 00 = 2 name :- “Googlem; 
Cino mam Dame = SMICTOSOECGS} 


F: 
console.table(arrTable); 


console.table(arrTable, "name"); 


将 这 段 代 码 保 存 为 名 为 table.js 的 文件 。 利 用 node table 命令 运行 这 个 文件 , 可 以 在 控制 台 
看 到 各 个 循环 的 使 用 时 间 统 计 ， 如 图 3.11 所 示 。 


图 3.11 console.table0 输 出 表格 信息 


本 .人 处。 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


1. 简要 介绍 JavaScript 的 语法 。 

2. JavaScript 中 将 其 他 数据 类 型 转化 为 布尔 值 时 需要 注意 哪些 地 方 ? 

3. 文中 提 到 JavaScript 的 编程 规范 有 哪些 ? 如 果 由 你 来 主导 一 个 JavaScript 项 目 ， 你 会 怎 
样 制定 这 个 项 目的 规范 ? 

4. Node.js 中 的 控制 台 如 何 统计 代码 的 运行 时 间 ? 

5. Node.js V10 版 本 中 新 增 的 console.table0 方 法 如 何 使 用 ? 
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Node.js 的 模块 加 载 机 制 可 以 让 你 开发 时 更 好 地 划分 程序 的 功能 ， 从 而 更 好 地 做 到 代码 解 
耦 ， 同 时 有 利于 进行 模块 化 开发 ， 保 证 写 出 的 Node.js 代码 优雅 、 易 读 。 同 时 ，Node.js 的 包 管 
理工 具 NPM 可 以 很 方便 地 下 载 使 用 第 三 方 模块 ， 简 化 开发 工作 ， 提 高 项 目 开发 效率 。 本 章 将 
介绍 Node.js 的 包 管 理工 具 NPM 的 使 用 和 Node.js 核心 模块 的 使 用 。 

通过 本 章 的 学 习 ， 可 以 掌握 以 下 内 容 : 


@ 从 NPM 下载 使 用 第 三 方 模块 ， 并 了 解 package.json 文件 的 使 用 。 

© 了 解 Node.js 的 模块 机 制 。 

e 通过 实例 了 解 Node.js 核心 模块 的 使 用 ， 通 过 实例 的 讲解 快速 掌握 各 个 核心 模块 的 常 
用 方法 。 


4.1 支持 最 新 版 NPM 


NPM 是 Nodejjs 的 包 管 理工 具 。 它 的 重要 性 就 像 gem 之 于 Ruby 一 样 。Node.js 与 NPM 的 
关系 是 密 不 可 分 的 。 
4.1.1 NPM 常用 命令 


NPM 默认 是 与 Node.js 一 起 安装 的 ， 可 以 在 命令 行 中 输入 “npm”， 验 证 NPM 是 否 安装 ， 
如 图 4.1 所 示 。 


图 4.1 NPM 验证 安装 结果 
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1. nom -v. npm version 


通过 输入 npm — v 命令 或 者 npm version 命令 可 以 查看 NPM 的 安装 版 本 ， 如 图 4.2 所 示 。 


图 4.2 NPM 查看 版 本 结果 


2. npm 安装 和 更 新 到 最 新 版 

通过 输入 npm install 命令 可 以 安装 最 新 版 的 NPM 包 管 理工 具 ， 具 体 命 令 如 下 : 
npm install npm 或 npm install -g npm 

如 果 想 安装 到 指定 的 NPM 版 本 〈 如 v6.2.0 版 本 ) ， 可 以 执行 如 下 命令 : 

npm install npm@6.2.0 或 npm install -g npm@6.2.0 


注意 ,， 如果 在 安装 过 程 中 出 现 停滞 或 卡 死 现象 ,往往 是 默认 选择 了 境外 服务 器 的 原因 。 此 
时 读者 不 必 担 心 ,更 换 选 择 镜像 服务 器 (譬如 国内 的 镜像 安装 源 ) 地 址 就 可 以 解决 了 。 具 体 合 
令 如 下 : 


npm config set registry http://npm 安装 源 地 址 


3. npm init 

通过 npm init 命令 可 以 生成 一 个 package.json 文件 。 这 个 文件 是 整个 项 目的 描述 文件 。 
通过 这 个 文件 可 以 清楚 地 知道 项 目的 包 依赖 关系 、 版 本 、 作 者 等 信息 。 每 个 NPM 包 都 有 
自己 的 package.json 文件 ， 使 用 这 个 命令 将 需要 填写 项 目 名 、 版 本 号 、 作 者 等 信息 ， 具 体 
如 图 4.3 所 示 。 
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43 npm init 生成 package.json 文件 
填写 完毕 后 ， 可 以 看 到 在 使 用 命令 的 文件 夹 中 多 了 一 个 package.json 文件 。 当 然 ， 如 果 读 
者 不 想 填 写 这些 内 容 ， 也 可 以 在 这 条 命令 后 添加 参数 -y 或 者 --yes， 这 样 系统 将 会 使 用 默认 值 
生成 package.json 文件 ， 例 如 : 
Tipon i i EE N 
Z for 
npm int ——yes 


4. npm install 安装 第 三 方 库 


通过 npm install 命令 安装 包 ， 如 安装 underscore 包 (underscore 是 一 个 强大 的 JavaScript 
工具 库 ， 使 用 这 个 库 可 以 大 大 提高 开发 效率 ) ， 如 图 4.4 所 示 。 


4.4 安装 underscore 的 结果 
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命令 运行 完毕 后 , 可 以 发 现在 运行 命令 的 文件 夹 中 多 了 一 个 名 为 node-modules 的 文件 夹 (用 
来 存放 安装 包 的 文件 夹 ) 。 打 开 这 个 文件 夹 就 可 以 找到 名 为 underscore 的 文件 夹 (用 来 存放 
underscore 包 ) ， 如 图 4.5 所 示 。 


| ] LICENSE 文件 2 KB 
J: package.json JSON 文件 3 KB 
3: README.md MD 文件 2 KB 
E underscorejs JS 文件 52 KB 
E underscore-minjs JS 文件 17 KB 
B underscore-min.map Linker Address ... 27 KB 


4.5 underscore 文件 夹 下 的 文件 


在 安装 包 的 时 候 同 样 可 以 在 命令 后 添加 --save 或 者 -S 参数， 这样 安装 包 的 信息 将 会 记录 在 
package.json 文件 的 dependencies 字段 中 ， 如 图 4.6 所 示 。 这 样 将 可 以 很 方便 地 管理 包 的 依赖 
> z "ç 9 

"dependencies": £ 


"underscore": "^1.9.1" 


1 
图 4.6 使 用 --save 参数 安装 


当然 ， 如 果 这 个 包 只 是 开发 阶段 需要 ， 可 以 继续 添加 -dev 参数 。 这 样 安 装 包 的 信息 将 会 
记录 在 package.json 文件 的 devDependencies 字段 中 ， 如 图 4.7 所 示 。 


"devDependencies": { 
"underscore™”: "A1.9.1" 


1; 
47 使用--save-dev 参数 安装 


建议 将 所 有 项 目 安装 的 包 都 记录 在 package.json 文件 中 。 当 我 们 的 package.json 文件 中 有 
依赖 包 的 记录 时 ， 只 需要 运行 npm install 命令 ， 系 统 就 会 自动 安装 所 有 项 目 需要 的 依赖 包 。 
当 不 需要 使 用 某 个 包 时 ， 可 以 运行 npm uninstall 命令 来 和 卸载 这 个 包 。 


4.1.2 package .json 文件 


上 文 提 到 package.json 文件 是 提供 包 摘 述 的 文件 。 在 Node.js 中 ， 一 个 包 是 一 个 文件 夹 ， 
文件 夹 中 的 package.json 文件 以 json 格式 存储 该 包 的 相关 描述 。 一 个 典型 的 package.json 文件 
内 容 (这 是 underscore 的 package.json 文件 ， 有 删 减 ) 如 下 : 

{ 


authors: 


"name": "Jeremy Ashkenas", 

"email": "jeremy@documentcloud.org" 
}, 
rbuqs”>: i 
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下 面 对 主 要 的 字段 进行 说 明 。 


© name: 包 的 名 字 。 

repository: 包 存 放 的 仓库 地 址 。 

keywords: 包 的 关键 字 ， 有 利于 别人 通过 搜索 找到 你 的 包 。 
license: 遵循 的 协议 。 

maintainers: 包 的 维护 者 。 
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author: 包 的 作者 。 

version: 版 本 号 ， 遵 循 版 本 命名 规范 。 
dependencies: 包 依 赖 的 其 他 包 .。 
devDependencies: 包 开 发 阶段 所 依赖 的 包 。 
homepage: 包 的 官方 主页 。 


当然 以 上 仅 列 举 了 第 见 的 字段 ， 所 有 的 字段 解释 说 明 读 者 可 以 在 https://docs.npmjs.com/ 
files/package.json 找到 。 


模块 加 载 原理 与 加 载 方式 


Node.js 中 的 模块 可 以 分 为 原生 模块 和 文件 模块 。 在 Node.js 中 可 以 通过 require 方法 导入 
模块 ， 通 过 exports 方法 导出 模块 。 


4.2.1 require 导入 模块 


对 于 原生 模块 (如 http) ， 只 需要 使 用 require Chttp') 导入 这 个 模块 并 将 其 赋值 给 一 个 变 
量 即 可 使 用 这 个 模块 导出 的 属性 、 方 法 等 。 

const http = require('http'"'); 

http.createServer ( 


// your code 


) 


对 于 文件 模块 ， 可 以 使 用 “./” 前 组 来 指 代 当 前 路 径 ， 从 而 使 用 相对 路 径 来 加 载 模块 。 加 
载 模块 时 ， 可 以 省 略 .js 拓展 名 。 例 如 ， 在 同 级 的 文件 夹 node 中 有 一 个 名 为 myModule.js 的 文 
件 模块 ， 可 以 这 样 导 入 : 


const myModule = require ('./node/myModule'); 


在 4.1 市 中 利用 NPM 下 载 了 underscore 模块 ， 在 node modules 文件 夹 的 同 级 目录 可 以 这 
样 加 载 : 


const underscore = require('./underscore'); 


这 是 因为 Node.js 内 部 会 自动 但 找 加 载 node modeles 文件 夹 下 的 模块 。 

这 里 有 必要 了 解 一 下 Nodejs 答 试 路 径 的 顺序 。 例 如 ， 某 个 模块 的 绝对 路 径 是 
home/hello/hello.js， 在 该 模块 中 导入 其 他 模块 ， 写 法 为 require("me/first")， 则 Node.js 会 依次 党 
试 使 用 路 径 : 

/home/hello/node modules/me/first 


/home/node modules/me/first 
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node modules/me/first 


42.2 exports 导出 模块 


一 个 模块 中 的 变量 和 方法 只 能 用 于 这 个 模块 , 如 果 想 要 与 其 他 模块 共享 一 些 方 法 、 属 性 等 ， 
就 可 以 用 exports 导出 一 个 对 象 。 这 个 对 象 可 以 包含 想 要 与 其 他 模块 共享 的 方法 和 属性 等 。 

假设 一 个 模块 中 有 两 个 想 要 与 其 他 模块 共享 的 方法 , 一 个 用 于 数组 去 重 , 一 个 用 于 计算 数 
组 之 和 ， 可 以 像 下 面 这 样 导 出 : 


const util = { 
noRepeat: function (arr) { 
return arr-filter(function(ele, index) | 
return arr.indexOf (ele)==index; 
1); 
Er 
add: FUNCETON (ACEI 
return arr .reduce (function (elel, ele2) { 
return elel ele2s 


J); 
}; 


module .exports = util; 


假设 将 这 个 模块 保存 为 exports.js， 同 级 目录 下 通过 require 使 用 该 模块 ， 代 码 如 下 : 


const arrEn = require(":/exports"}; 


const are mii 23 3 2; 


let noRepeatArr = arrFn.noRepeat (arr); 


let num = arrFn.add (arr); 


console.log (noRepeatArr); 


console.log (num); 


假设 将 这 个 模块 保存 为 require.js， 运 行 这 段 代 码 后 ， 可 以 在 控制 台 看 到 输出 数组 [1,2,3] 和 
数字 11， 说 明 模 块 导入 成 功 ， 如 图 4.8 所 示 。 


Node.js command prompt - node 


> console. log (noRepeatArr) : 
Lt >. +1 


efined 


48 导入 模块 与 导出 模块 
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Node.js 核心 模块 


Node.js 的 核心 模块 主要 有 http. http2, fs. url. querystring 模块 。 下 面 分 别 对 这 几 个 模块 
进行 分 析 。fs 模块 在 第 5 章 详 细 介 绍 。http 模块 在 第 2 章 的 例子 中 使 用 过 ， 本 节 将 详细 分 析 其 
方法 和 原理 。 男 外 ，http2 模块 是 对 http 模块 的 技术 升级 ， 是 Node.js V10 版 本 中 主要 的 新 特性 
之 一 。 虽 然 目前 http2 模块 的 功能 仍 处 于 实验 阶段 ， 但 是 十 分 有 必要 让 读者 先行 了 解 一 下 该 模 
块 的 概念 。 


4.3.1 http 模块 一 一 创建 HTTP 服务 器 和 客户 端 


使 用 http 模块 只 需要 在 文件 中 通过 require(http7) 引 入 即 可 。http 模块 是 Node.js 原生 模块 
中 最 为 亮 眼 的 模块 。 传 统 的 HTPP 服务 器 会 由 Apache、Nginx、IIS 之 类 的 软件 来 担任 ， 但 是 
Node.js 并 不 需要 。Node.js 的 http 模块 本 号 就 可 以 构建 服务 器 ， 而 且 性 能 非常 可 靠 。 


1. Node.js 服务 器 端 
下 面 创建 一 个 简单 的 Node.js 服务 器 。 
【示例 4-1] 


const http = require ('http'); 


const server = http.createServer (function (req, res) { 
res.writeHead (200, (í 
'content-type': 'text/plain' 
J); 
res.end('Hello, Node.js!'); 
}); 
server.listen(3000, function() í 
console log( Listening port 30007); 
}); 


【代码 说 明 】 
运行 这 段 代 码 ， 在 浏览 器 中 打开 http://localhost:3000/ 或 者 http://127.0.0.1:3000/， 页 面 中 显 
示 “Hello，Node.js! ”文字 。 
http.createServer(0) 方 法 返回 的 是 http 模块 封装 的 一 个 基于 事件 的 http 服务 器 。 同 样 ， 
http.request 是 其 封装 的 一 个 http Ar im LH, a AHRI http 服务 器 发 起 请 求 。 上 面 的 req 和 
res 分 别 是 http.IncomingMessage 和 http.ServerResponse 的 实例 。 
http.Server 的 事件 主要 有 : 


© request: 最 常用 的 事件 ， 当 客户 端 请 求 到 来 时 ， 该 事件 被 触发 ， 提 供 req 和 res 两 个 
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© connection: 当 TCP 连接 建立 时 ， 该 事件 被 触发 ， 提 供 一 个 socket 参数 ， 是 netSocket 
的 实例 。 
© close: 当 服 务 器 关闭 时 ， 触 发 事件 ( 注意 不 是 在 用 户 断 开 连 接 时 ) 。 


http.createServer() 方 法 其 实 束 是 添加 了 一 个 request 事件 监听 ,利用 下 面 的 代码 同样 可 以 实 
现 【 示 例 4-1】 的 效果 。 


【示例 4-2] 
Conste DEED — reguirel( NEED): 


const server = new http.Server((); 


server.on('request', function (req, res) { 
res.writeHead (200, í 
'content-type': 'text/plain' 
)); 
res Endid Hel Node si) 


)) ; 


server.listen(3000, function() { 
console.log" listening port 30001); 
}); 


http.IncomingMessage 是 HTTP 请 求 的 信息 ， 提 供 了 以 下 3 个 事件 : 

© data: 当 请 求 体 数据 到 来 时 该 事件 被 触发 。 该 事件 提供 一 个 chunk 参数 ， 表 示 接 收 的 
数据 。 

© end: 当 请 求 体 数据 传输 完毕 时 该 事件 被 触发 ， 此 后 不 会 再 有 数据 。 

© close: 用 户 当 前 请 求 结束 时 ， 该 事件 被 触发 。 

http.IncomingMessage 提供 的 属性 主要 有 : 

@ method: HTTP 请 求 的 方法 ， 如 GET. 

@ headers: HTTP 请 求 头 。 

© url: 请 求 路 径 。 

@ httpVersion: HTTP 协议 的 版 本 。 

将 上 面 提 到 的 知识 融合 到 【示例 4-1】 的 服务 器 代码 中 。 


【示例 4-3] 


const http = require ("'hEtp'); 


const server = http.createServer(function(req, res) { 
let data = '"'; 
reg-on( datai; Eunction (chunk); 1 


data += chunk; 
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J); 


Fedom end Tunctiorn() [ 


let method = req.method; 


let url = req.url; 


let headers = JSON.stringify(req.headers); 


let httpVersion = req.httpVersion; 


res writeHead(200, [ 


J); 


'content-type': 'text/html' 


let dataHtml = '<p>data:'" + data + '</p>'; 
let methodHtml = '<p>method:' + method + '</p>'; 


tet ELHEmD Ele Gri iris pss. 


let headersHtml = '<p>headers:' + headers + '</p>'; 


let httpVersionHtml = '<p>httpVersion:' + httpVersion + '</p>'; 
let resData = dataHtml + methodHtml + urlHtml + headersHtml + httpVersionHtml; 


res.end(resData); 


ENS 
Fi: 


server.listen(3000, function() í 


consote ` logl' listening port 3000"); 


}); 


打开 浏览 器 输 入 地 址 后 ， 可 以 在 浏览 器 页 面 中 看 到 如 图 4.9 所 示 的 信息 。 


文件 (EF) SSH EEV 历史 (6) 书签 (68) 工具 中 ”帮助 (H) 


localhost:3000/ x I 
E Œ] © localhost:3000 
data: 

method:GET 

url:/ 


headers:("host":"localhost:3000","user-agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 


11 0 1 like Mac OS X) AppleWebKit/604.1.38 (KHTML, like Gecko) Version/11.0 
Mobile/15A402 Safari/604.1","accept":"text/html,application 
/xhtml+xml,application/xml;q=0.9,*/*;:q=0.8","accept-language":"zh-CN,zh; 
q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2","accept-encoding":"gzip, 
deflate","cookie":"Webstorm-ef44d83f=6e80d9e5-303c-4f7d-9756- 
a5fbdf29e865","connection":"keep-alive","upgrade-insecure-requests":"1") 


httpVersion:1.1 


图 4.9 HTTP 浏览 器 效果 


http.ServerResponse 是 返回 给 客户 端的 信息 ， 其 第 用 的 方法 为 : 
@ res.writeHead(statusCode,[headers]): 向 请 求 的 客户 端 发 送 响应 头 。 
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这 些 方法 在 上 面 的 代码 中 已 经 演示 过 了 ， 这 里 就 不 再 演示 了 。 


2. SPm http 服务 器 发 起 请 求 


以 上 方法 都 是 http 模块 在 服务 器 端的 使 用 ， 接 下 来 看 客户 端的 使 用 。 同 http 服务 器 发 起 
请 求 的 方法 有 : 


© http.request(option[.callback]): option 为 json 对 象 , 主要 字段 有 host. port( 默认 为 80 )、 
method ( 默认 为 GET ) path (请求 的 相对 于 根 的 路 径 ， 默 认 是 “/” ) 、headers 等 。 


该 方法 返回 一 个 httpClientRequest 实例 。 


@ http.get(option[.callback]): http.requestO 使 用 HTTP 请 求 方式 GET 的 简便 方法 。 


同时 运行 【示例 4-1】 和 【示例 4-4】 的 代码 , 我 们 可 以 发 现 命令 行 中 输出 “Hello, Node.js!” 
字样 ， 表 明 一 个 简单 的 GET 请 求 发 送 成 功 了 。 


【示例 4-4】 


const http = requrre("'http"'); 


let reqData = ''; 


http.request ({ 


]; 


host e HT 0 05 am 
"port OU 
'method': 'get' 
function (res) i 


res on[("data"; function(chunk) 1 


reqData += chunk; 


I); 


res orn("end", functiori()” | 


console.log(reqData) ; 


}); 


tendi); 


利用 http.get0 方 法 也 可 以 实现 同样 的 效果 。 


【示例 4-5】 


const http  — require ('HhEtEph); 


let reqData = ''; 
fPetp get (1 


]; 


"host" r 127 0 Ds 1 
"port = 3000: 
Ffisrict pon (res) 1 


res oní(r"data', function (chunk) { 


reqData += chunk; 


Df 
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l): 
reson("ernd',; furnction() i 
console.log (reqData); 
J); 
}) .end (); 


与 服务 端 一 样 ，http.request() 和 http.get() 方 法 返回 的 是 一 个 http.ClientRequest() 实 例 。 
http.ClientRequest() 类 主要 的 事件 和 方法 有 : 


@ response: 当 接 收 到 响应 时 触发 。 
@ request.write(chunk[.encoding][.callback]): 发 送 请 求 数 据 。 
@ res.end([datal[,encoding][,callback]): 发 送 请 求 完 毕 ， 应 该 始终 指定 这 个 方法 。 


同样 可 以 改写 上 述 代码 为 【示例 4-6】。 


【示例 4-6] 
conste NEED Tredqurre ('httipš); 
let reqData = ''; 
let option= ( 
POSE s TIA oO eg 
port S. OU 
}; 


const req = http.request (option); 


req.on('response', function (res) { 
ress On( data fFenction (chunk) J 
reqData += chunk; 
J); 
reseonl end  tunctiorr(" [ 
console.log (reqData); 
1); 
}); 


4.3.2 http2 模块 一 一 创建 HTTP/2 服务 器 和 客户 端 


使 用 http2 模块 同样 只 需要 通过 require('http2)5| ABT, Node.js V10 版 本 已 经 将 其 作为 
默认 模块 来 使 用 了 。http2 模块 是 对 HTTP/2 协议 的 Node 实现 , 该 协议 是 一 个 二 进 制 复 用 协议 。 
HTTP/2 协议 主要 是 实现 了 并 行 请 求 能 在 同一 个 链接 中 进行 处 理 ， 移 除了 HTTP/1.x 协议 中 关 
于 顺序 和 阻塞 的 约束 ， 压 缩 了 headers， 人 允许 服务 器 在 客户 端 缓存 中 填充 数据 ， 并 通过 服务 器 
推送 机 制 来 提前 请 求 ， 等 等 。 这 里 关于 HTTP/2 协议 的 具体 内 容 就 不 展开 了 ， 读 者 可 以 参考 相 
关 文 档 。 下 面 主要 介绍 通过 http2 模块 创建 HITP/2 服务 器 和 客户 端 。 
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1. Node.js HTTP/2 服务 器 端 
下 面 创 建 一 个 简单 的 Node.js HITP/2 服务 器 。 
【示例 4-7 】 


const http2 = reqüire("http2"); 


const fs = reguire ("fs"); 


const server = http2.createSecureServer ({ 
key: fs.readFileSync('./ssl/localhost-privkey.pem'), 
cert: fs.readFileSync('./ssl/localhost-cert.pem') 


I 


server.listen(8443); 


【代码 说 明 】 
http.createSecureServer() 方 法 返回 的 是 http2 模块 封装 的 一 个 基于 事件 的 http2 服务 器 ， 并 
通过 listen(0) 方 法 监听 客户 端 请 求 。 
这 里 与 http 模块 显著 不 同 的 地 方 是 ,http2 模块 需要 依赖 于 sl 安全 证 书 来 实现 ,因此 就 需 
要 配合 使 用 fs 文件 模块 来 引用 证 书 文 件 。 另 外 ， 本 例 中 所 引用 的 sl 安全 证 书 文件 请 参考 本 书 
配套 的 源 代码 ， 读 者 可 以 直接 借用 到 自己 的 项 目 中 使 用 。 
下 面 是 一 个 完整 的 Node.js HTTP/2 服务 器 代码 。 


【示例 4-8】 


eesti 


const http2 = require ('http2');/ 


const fs = require('fs'); 


const server = http2.createSecureServer ({ 
key: fs.readFileSync('./ssl/localhost-privkey.pem'), 
cert: fs.readFileSync('./ssl/localhost-cert.pem') 


i): 
server.on('error', (err) => console.error (err)); 


server.on('stream', (stream, headers) => { 
// stream is a Duplex 
stream.respond (í 
'content-type': 'text/html', 
"Status": 200); 
stream.end ('<hl>Hello HTTP2</hl>'); 
1); 
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server.listen(8443); 
【代码 说 明 】 
HTTP/2 服务 器 端 定 义 的 server 使 用 了 以 下 2 个 事件 和 1 个 方法 : 


© stream: 当 请 求 体 数据 到 来 时 该 事件 被 触发 .该 事件 提供 2 个 参数 ( stream 和 headers )， 
表示 数据 流 和 文件 响应 头 信 息 。 通 过 数据 流 stream 实现 了 向 客户 端 发 送信 息 : 
@ ”通过 respond0 方 法 向 客户 端 定 义 了 文件 响应 头 信 息 。 
@ ”通过 end() 方 法 向 客户 端 发 送 了 文本 内 容 ， 并 结束 请 求 。 

@ error: 错误 信息 。 

© 通过 1listen() 方 法 监听 客户 端 请 求 (端口 为 8443 ) 。 

2. Node js HTTP/2 客户 端 向 服务 器 端 发 起 请 求 

接着 介绍 如 何 创建 Node.js HTTP/2 客户 端 ， 并 向 http2 服务 器 发 起 请 求 。 

© http2.connect(url, options): url 为 请 求 的 服务 器 地 址 和 端口 ，option 为 json 对 象 ， 该 方 
法 返回 一 个 http2session 实例 。 

© http2session.request(headers[, options]): 请 求 headers 相对 于 根 的 path 路 径 (默认 是 “/”)， 
该 方法 返回 一 个 http2stream 实例 。 


【示例 4-9】 


“use Strict; 


const http2 = require('http2!}; 


const fs — regurre("FsS")| ; 

const client = http2 connect ('"https://localhost:8443'; I 
ca: fs.readFileSync('./ssl/localhost-cert.pem') 

11: 

elient on "error" lerr] S Fconsote-error(err))r; 

const req = client.request((':path': '/')); 

req setëncoding(rutr8:"); 

let data = ""'; 

reg:-on{'data!; (chunk) => I 


data += chunk; 


Fk: 
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req.on('end', () = { 
console.log('\n' + data); 
client.close () ; 


l); 


req.end() ; 


【代码 说 明 】 


client.request 方法 返回 的 是 一 个 http2stream 实例 (req) ， 其 主要 的 事件 和 方法 有 : 

@ setEncoding(0 方 法 : 设 定 文件 编码 类 型 。 

© data 事件 : 发 送 请 求 数据 。 

@ end 事件 : 发 送 请 求 完毕 ， 并 关闭 客户 端 。 

@ end0 方 法 : 发 送 请 求 完毕 ， 应 该 始终 指定 这 个 方法 。 

下 面 分 别 运行 服务 器 端 和 客户 端 脚本 文件 ， 然 后 打开 浏览 器 ， 输 入 地 址 


(https:/localhost:8443) ， 可 以 在 浏览 器 页 面 中 看 到 如 图 4.10 所 示 的 信息 。 
XH ”编辑 人 E) EEV PLO 书签 四 工具 中 帮助 (H) 


localhost:8443/ 


€)— Œ CO BË, Rhttps://localhost:8443 


Hello HTTP2 


图 4.10 HTTP/2 浏览 器 效果 


如 图 4.10 中 箭头 所 示 ， 浏 览 器 地 址 中 ， 双 图标 表示 该 地 址 为 不 安全 的 ， 并 标识 为 例外 站 
点 信息 。 


4.3.3 ur 模块 一 一 url 地 址 解析 


使 用 ul 模块 只 需要 在 文件 中 通过 require(url) 引 入 即 可 。murl 模块 是 一 个 分 析 、 解 析 url 
的 模块 ， 主 要 提供 以 下 三 种 方法 : 
@ url.parse(urlStr[.parseQueryString][.slashesDenoteHost]): 解析 一 个 url 地 址 ， 返 回 一 个 
url 对 象 。 
© url.formate(urlObj): 接收 一 个 url 对 象 为 参数 ， 返 回 一 个 完整 的 url 地 址 。 
@ urlresolve(from, to): 接收 一 个 base url 对 和 象 和 一 个 hrefurl 对 象 ， 像 浏览 器 那样 解析 ， 
返回 一 个 完整 地 址 。 
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【示例 4-10] 
CONS EURIE T regUIrTeE (!ur n) 


let parseUrl = 'https://www.google.com/?q=node.js'; 


let urlObj = url.parse (parseUrl); 
console. Log (url0bj}:; 


在 控制 台中 输出 如 图 4.11 所 示 的 信息 ， 说 明 解 析 成 功 。 


Nodejs command prompt 


4.11 解析 url 地 址 
利用 url.format0 方 法 返回 上 述 完整 地 址 的 代码 如 下 : 
【示例 4-11 】 


const url = require('"url"); 


let urlobj = ( 
'host': "www.qooqle. com", 
四 else 二 二 WE 
'protocotu: TI NECpS i, 
'search':'?q=node.js', 
'query': 'q=node.js', 
pathr Tn 
l: 
let urlAdress = url.format (urlObj) ; 


console.log(urlAdress); 


运行 代码 后 ， 可 以 在 控制 台 看 到 完整 的 url 地 址 。 
resolve 的 使 用 方法 如 下 : 


【示例 4-12] 


const url = require ("üúrl"); 


let urlAdress = url.resolve ('https://www.google.com', '/image'); 
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console.log (urlAdress); 


运行 代码 ， 可 以 在 控制 台 看 到 完整 的 url 地 址 : https://www.google.com/image。 
4.3.4 url 模块 一 WHATWG URL 地 址 解析 


WHATWG URL 是 由 WHATWG 标准 化 组 织 提出 的 ,对 ul 地址 进行 标准 化 的 实现 .Node.js 
中 的 url 模块 提供 了 两 套 API 来 处 理 URLs: 一 套 是 Node.js 遗留 的 特有 API， 另 一 套 是 在 Web 
浏览 器 中 实现 了 WHATWG URL Standard 的 API.Node.js 从 v8.0.0 版 本 开始 对 WHATWG URL 
API 提供 完整 支持 。 在 Web 浏览 器 中 ，WHATWG URL 在 全 局 中 总 是 可 用 的 。 下 面 看 一 个 关 
于 url 模块 处 理 WHATWG URL 的 代码 示例 。 


【示例 4-13】 
/* url parse */ 
const url = require('url'); 
const myURL = url.parse('https://www.google.com/?q=node.js'); 
console.log (myURL); 


/* WHATWG URL API */ 

const [UR] = require("uri"); 

const myWHATWGURL = new URL ('https://www.google.com/?q=node.js'); 
console.log (myWHATWGURL); 


【代码 说 明 】 


url 模块 处 理 WHATWG URL 时 与 传统 方式 不 同 , 是 通过 new URL0O 方 法 来 实现 的 。 同时 ， 
在 引用 url 模块 时 ， 也 是 通过 对 象 方式 来 实现 的 {URL}) 。 


下 面 通过 控制 台 进 行 输出 ， 对 比 一 下 两 种 url 处 理 方式 得 出 的 结果 的 区 别 ， 具 体 如 图 4.12 
所 示 。 


通过 ur1. parse 方 法 地 址 解析 得 到 的 结果 标准 化 WHATWG URL 地 址 解析 得 到 的 结果 


4.12 解析 WHATWG URL 地 址 
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4.3.5 querystring 模块 一 一 查询 字符 串 处 理 

使 用 querystring 模块 只 需要 在 文件 中 通过 require('querystring)h 5| ABR]. querystring 模块 
是 一 个 处 理 查 询 字 符 串 的 模块 。 这 个 模块 的 主要 方法 有 : 

© querystring.parse(): 将 查询 字符 串 反 序列 化 为 一 个 对 象 ， 类 似 JSON .parse()。 

© querystring.stringify0: 将 一 个 对 象 序列 化 为 一 个 字符 串 ， 类 似 JSON .stringify()。 

下 面 溪 示 它们 的 使 用 方法 。 

将 查询 字符 串 反 序列 化 为 一 个 对 象 。 

【示例 4-14] 


const querystring = require ('querystring'); 


let str = 'keyWord=node.js&name=huruji'; 


EDI urnv Senn parse (sir; 


console.log (obj); 
将 对 象 序列 化 为 一 个 查询 字符 串 。 
【示例 4-15 】 


const querystring = require ('querystring'); 
let obj = { 

keyWord: 'node.js', 

name: 'huruji' 


j: 


tlet str = querystring. stringitfyvy(obDj]; 


eonsole log(sEr); 


Node.js 党 用 模块 


除了 上 述 提 到 的 核心 模块 外 ，Node.js 还 有 一 些 常 用 的 模块 。 


4.4.1 util 模块 一 一 实用 工具 及 功能 
util 模块 是 一 个 工具 模块 ， 提 供 的 主要 方法 有 : 


© utilinspect(): 返回 一 个 对 象 反 序列 化 形成 的 字符 串 。 

© utilformat(): 返回 一 个 使 用 占 位 符 格 式 化 的 字符 串 ， 类 似 于 C 语言 的 printf。 可 以 使 
用 的 占 位 符 有 %s、%d、%j。 

@ nutillog0: 在 控制 台 输 出 ， 类 似 于 console.log()， 但 这 个 方法 带 有 时 间 蕉 。 
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下 面 将 用 代码 说 明 这 些 方法 的 使 用 。 
【示例 4-16 】 


const util = require (7 ucil7) > 


let obj = { 
keyWord: 'node.js', 
name: huruji” 
1: 
Jet str — util. inspect (obj); 


console- log(sEr}); 

上 面 这 段 代 码 已 经 将 对 象 反 序列 化 为 一 个 字符 串 。 之 所 以 说 这 个 方法 在 调试 的 时 候 非 常 有 
H, 是 因为 我 们 还 可 以 让 控制 台 输 出 的 字符 串 带 有 颜色 和 风格 。 这 非常 有 利于 区 分 各 种 数据 类 
JJ. Node.js 默认 的 风格 可 参考 表 4-1。 


表 4-1 Node js 默认 的 风格 
数据 类 型 


只 需要 在 inspect( 方 法 中 添加 一 个 json 对 象 参 数 ， 将 color 字段 设置 为 true 即 可 。 
【示例 4-17] 


Const util = regure util"); 


let obj = { 
keyWord: 'node.js', 
name: 'huruji' 

}; 

let str = util.inspect (obj,t{ 
"colori: ETUE 


)); 


console Tog(sEr); 


WR util.format 方法 中 的 参数 少 于 占 位 符 ， 那 么 多 余 的 占 位 符 不 会 被 蔡 换 ;， 如 果 参 数 多 于 
占 位 符 ， 那 么 剩余 的 参数 将 通过 util.spect0 方 法 转换 为 字符 串 ;， 如 果 没 有 占 位 符 ， 束 将 以 空格 
分 隅 各 个 参数 并 拼接 成 字符 串 。 


【示例 4-18] 


const util — require('util!); 
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Uei ormake (sae 


FI barnyi 1S 12 


ueil Fornmat( Ts 1S a 5S5S',; 


// huruji is a FE%s 


uri ru tormat (tss aisial, 


// Bhüuruji is a FE 


Uel Format (!Pirrir pu rais 


// huruji is a FE 


“papa 552); 


r itirdi; a PE n) 


"uriy re Eh ys 


q S> a TEEN)? 


除了 这 些 方法 外 ，nutil 模块 还 提供 了 一 些 判 断 数据 类 型 的 图 数 ， 如 utilisArray0、 
util.isRegExp()、util.isDate() 等 。 


从 Node.js V10 版 本 开始 ，util 模块 增加 了 一 组 关于 types 类 型 的 方法 ， 可 以 实现 对 象 类 型 
的 判断 。 下 面 是 一 个 关于 如 何 使 用 util 模块 types 类 型 方法 的 代码 示例 ， 列 举 了 一 小 部 分 比较 


第 用 的 方法 。 
【示例 4-19】 


conste ueil 


console.log (util.types. 
console.log (util.types. 


console.log (util .types. 
console: log (util.:types- 


console.log (util.types. 
console.log (util.types. 


console.log (util.types. 
console: log(util ECEypes: 
console.log (util.types. 
console.log (util.types. 
console.log (util.types. 
console.log (util.types. 


const map new Map () ; 


console.log (util.types. 
console.log (util.types. 
console.log (util.types. 


console.log (util.types. 
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reguire(1util!); 


isStringObject('foo')); // Returns false 


isStringObject (new String ('foo'))); // Returns true 
isArrayBuffer (new ArrayBuffer())); // Returns true 
isArrayBuffer (new SharedArrayBuffer()));// Returns false 
isAnyArrayBuffer(new ArrayBuffer())); // Returns true 
isAnyArrayBuffer (new SharedArrayBuffer()));//Returnstrue 
isBooleanObject (false)); // Returns false 
isBooleanObject (true) ); // Returns false 
isBooleanObject (new Boolean (false))); // Returns true 
isBooleanObject (new Boolean (true) ) ) ; // Returns true 
// Returns false 


// Returns false 


isBooleanObject (Boolean (false))); 


isBooleanObject (Boolean (true))); 


isMap (map)); // Returns true 


isMapIterator (map.keys())); // Returns true 
isMapIterator (map.values())); // Returns true 


isMapIterator (map.entries())); // Returns true 
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console.log(util.types.isMapIterator (map [Symbol .iterator] ())); // Returns true 


const set = new Set(); 

console.log(util.types.isMap(set)); // Returns true 
console.log(util.types.isSetIterator(set.keys())); // Returns true 
console.log (util.types.isSetIterator (set.values())); // Returns true 
console.log (util.types.isSetIterator (set.entries())); // Returns true 


console.log (util.types.isSetIterator (set [Symbol .iterator] ())); // Returns true 


function ucil types arguments) 1 
console.log (util.types.isArgumentsObject (arguments)); // Returns true 


} 


util types arguments(); 

【代码 说 明 】 

在 使 用 utiltypes 类 型 方法 时 要 注意 ， 所 有 方法 的 参数 部 必须 为 对 象 类 型 。 比 如 ， 判 断 字 
从 串 时 会 返回 “false” 结 果 ， 而 将 同样 的 字符 串 定义 为 String 对 象 时 则 会 返回 “true” 结 果 。 
为 外 ，util.types 类 型 方法 适用 范围 比较 广 ， 不 但 包括 基本 对 象 类 型 ， 还 包括 Set 和 Map 这 类 
集合 对 象 类 型 ， 甚 至 对 函数 对 象 也 定义 了 相应 的 方法 。 


4.4.2 path 模块 一 一 路 径 处 理 


path 模块 提供 了 一 系列 处 理 文件 路 径 的 工具 ， 主 要 的 方法 有 : 
© pathjoin0: 将 所 有 的 参数 连接 起 来 ， 返 回 一 个 路 径 。 
© pathextname(): 返回 路 径 参 数 的 拓展 名 ， 无 拓展 名 时 返回 空 字符 串 。 
© path.parse0: 将 路 径 解 析 为 一 个 路 径 对 象 。 
© path.format0: 接收 一 个 路 径 对 象 为 参数 ， 返 回 一 个 完整 的 路 径 地 址 。 
下 面 用 代码 说 明 这 些 方法 的 使 用 。 

【示例 4-20] 


const path = require ('path'); 


let outputFath = path-join( dirname, node node.js); 


console.log (outputPath); 


车 上 面 这 段 代码 文件 存放 的 文件 夹 为 C 盘 目 录 下 的 frontEnd XF, BH dirname 表示 
C:\frontEnd， 则 返回 : 


C:\frontEnd\node\node.js 


利用 path.extname0 方 法 解析 上 面 的 代码 返回 路 径 中 的 拓展 名 js， 代 码 如 下 : 
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【示例 4-21] 


const pathi—irequrre ("path"); 


let ext = path extname (path. Join dirname, "node", "node. Jj5")) $; 


console.log(ext); 


Æ Node.js 中 ,一 个 文件 对 象 有 root, dir, base, ext, name 五 个 字段 ， 分 别 对 应 根 目 录 (一 


般 是 磁盘 名 )、 完 整 目录 、 路 径 最 后 一 部 分 (可 能 是 文件 名 或 文件 夹 名 , 是 文件 名 时 带 拓展 名 )、 
拓展 名 、 文 件 名 《〈 不 带 拓 展 名 ) ， 可 以 利用 以 下 代码 将 上 面 的 地 址 解析 成 一 个 路 径 对 象 。 


【示例 4-22] 


const path = require ('path');/ 


const str = 'd:/nodejs/node.exe'; 


let obj = path.parse (str); 


console"loGsg(obj) ; 


我 们 将 在 控制 台 看 到 如 图 4.13 所 示 的 输出 。 


Nodejs command prompt 


图 4.13 解析 路 径 
如 果 我 们 将 控制 台 输 出 的 这 个 对 象 作为 path.format0 的 参数 使 用 ， 就 将 会 得 到 上 面 的 路 径 


字符 串 。 


4.4.3 dns 模块 


dns 模块 的 功能 是 域名 处 理 和 域名 解析 ， 常 用 的 方法 有 : 


@ dns.resolve(): 将 一 个 域名 解析 为 一 个 指定 类 型 的 数组 。 
@ dns.lookup(): 返回 第 一 个 被 发 现 的 IPv4 或 者 IPv6 地 址 。 
@ dns.reverse(): 通过 JP 解析 域名 。 


下 面 用 代码 说 明 这 些 方法 的 使 用 。 
可 以 通过 dns.resolve0 方 法 解析 一 下 百度 的 IPv4 地 址 。 


【示例 4-23】 
const dns = require ('dns'); 
let domain = 'nodejs.org'; 
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dns- resolve (domain, Function(err; address) T 
if(err) { 
console.log(err); 
PECENE 
} 
console.log (address); 


}) 
运行 代码 后 ， 可 以 在 控制 台中 看 到 如 图 4.14 所 示 的 数组 输出 。 


Node.js command prompt 


[ "104. 20. 22. 46', '104. 20. 23. 46' ] 


4.14 解析 DNS 


利用 dns.lookup(0 方 法 会 返回 上 面 这 个 数组 中 的 一 个 元 素 。 


【示例 4-24] 
const dns = require ('dns'); 
tet domain r "paidi: -comn.; 


dns .lookup (domain, function (err, address) { 
if (err) í 
console.log (err); 
TECUCI 


l 


console.log (address); 


}) 


笔者 控制 台 输 出 的 便 是 上 面 数 组 中 的 第 二 个 元 素 ， 即 111.13.101.208 这 个 地 址 。 读 者 可 以 
自行 查看 一 下 自己 网 络 返 回 的 地 址 。 

我 们 将 一 个 IP 地 址 114.114.114.114 传递 给 dns.reverse0 方 法 ， 就 会 得 到 一 个 域名 数组 ， 
不 过 这 个 数组 中 只 有 public1.114dns.com 这 个 域名 。 


【示例 4-25】 
const dns = require ('dns'); 


dns-reverse('114:114:114.114',;, function(erry domain) [Í 
console.log (domain); 


}) 


L.D 实战 一 一 他 取 网 页 图 片 


本 市 将 利用 本 章 所 介绍 的 知识 实现 一 个 完整 的 实例 : 利用 Node js 爬 取 一 个 网 页 ， 通 过 第 
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三 方 模块 cheeriojjs 分 析 这 个 网 页 的 内 容 ， 最 后 将 这 个 网 页 的 图 片 文件 保存 在 本 地 。 


4.5.1 项 目 目录 与 思路 
整个 实例 的 项 目 目录 如 图 4.15 所 示 。 
i img 
| | node_modules 


图 analyzejjs 
国 config.js 


图 indexjs 
3. package.json JSON 文件 


图 4.15 实例 项 目 目 录 

img 文件 夹 用 来 存储 图 片 文件 。 
node modules 文件 夹 是 模块 默认 的 保存 位 置 。 
index.js 文件 是 整个 项 目的 入 口 文件 。 
config.js 文件 是 配置 文件 ， 用 来 放置 网 页 地 址 和 图 片 文件 夹 的 路 径 。 这 样 做 的 目的 是 
使 整个 项 目的 可 拓展 性 增强 。 

© analyze .js 文件 用 来 存储 分 析 DOM 的 方法 。 

@ package.json 文件 是 包 的 描述 文件 。 

整体 的 思路 是 通过 第 三 方 模块 request 请 求 网 页 地 址 ， 从 而 得 到 整个 网 页 的 DOM 结构 ， 
根据 DOM 结构 利用 cheerio 模块 分 析出 图 片 文件 的 地 址 ， 再 次 请 求 这 个 地 址 ， 最 后 将 得 到 的 
图 片 数 据 储存 在 本 地 。 


452 下 载 第 三 万 模块 
如 前 面 章节 介绍 的 ， 我 们 可 以 利用 npm install 命令 下 载 需 要 的 模块 。 下 面 的 代码 就 可 以 
将 我 们 需要 的 request 和 cheerio 模块 下 载 到 本 地 : 


npm install request cheerio 


打开 node modules 文件 夹 便 可 找到 相应 模块 的 文件 。 


45.3 ”配置 网 页 地 址 及 图 片 存放 的 文件 夹 


这 里 将 配置 内 容 写 入 config.js 文件 中 ， 再 在 文件 中 通过 exports 导出 这 些 配置 内 容 ， 从 而 
使 其 他 文件 可 以 使 用 ， 代 码 如 下 : 
Il Config is 


const url = ' 填 写 具 体 网 址 '; 


const path = require (('path'); 
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const imgDir = path.join( dirname, 'img'); 


module .exports .ur = url; 


module .exports.imgDir = imgDir; 


这 里 读者 可 目 行将 请 求 的 网 址 填写 在 url 变量 中 。 


4.5.4 解析 DOM 得 到 图 片 地 址 


这 里 假设 我 们 已 经 得 到 了 DOM 结构 ， 将 分 析 DOM 部 分 的 代码 写 入 analyze.js 文件 中 ， 
通过 cheerio 得 到 每 一 张 图 片 的 地 址 ， 最 后 利用 一 个 回调 函数 callback 处 理 这 个 地 址 (当然 在 
这 里 回调 函数 callback 是 发 送 请 求 ) ， 代 码 如 下 : 


// analyze.js 


const cheerio = require ('cheerio'); 


firme or Eindimgldom ca lriibpac kimi 
let $ = cheerio.load (dom); 
$('img') .each (function(i, elem) { 
Tet imgSre = S(Ehis)'att8cr("'sre")s 
cal PDAcCk (ImgSre en 


}); 


module .exports.findIimg = findImg; 


cheerio 模块 可 以 使 开发 者 像 jQuery 一 样 操作 DOM。 这 里 得 到 了 请 求 网 页 中 每 一 张 图 片 
文件 的 地 址 。 读 者 可 以 通过 更 多 的 DOM 分 析 过 滤 部 分 不 需要 的 图 片 , 留 下 目 己 最 想 要 的 图 片 。 


45.5 ”请求 图 片 地 址 


这 里 将 请 求 的 操作 放 在 主 模块 index.js 文件 中 ， 将 config.js 和 analyze.js 文件 引入 这 个 模 
块 ,利用 request 模块 请 求 图 片 地 址 ,得 到 DOM 结构 .将 DOM 结构 交 给 analyze 模块 的 findImg0 
方法 进行 处 理 ， 代 码 如 下 : 
// index.js 
const request = require("request');/ 
const path = require ('path');/ 
const config = require ('./config'}); 


const analyze = require ('./analyze'!'); 


Tfurctiom start () i 
request (config.url, function(err, res, body) { 
console"log('srart"); 


if(!err && res) { 


Fa 
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console. log (1Start. ys 


analyze.findImg (body); 


4.5.6 ”图 片 文件 的 保存 


通过 分 析 DOM 结构 得 到 图 片 地 址 后 ， 利 用 request 再 次 发 送 请 求 ， 将 请 求 得 到 的 数据 写 
入 本 地 即 可 。 这 里 也 将 其 封 沪 成 一 个 函数 ， 退 加 在 index.js 文件 中 ， 代 码 如 下 : 


Funetlionmn downboad(rmgUyr li I) | 
let ext = imgüri- spirit (r"! `") popi; 
request (imgUr1) .pipe (fs.createWriteStream(path.join(config.imgDir, i + '.' + 
ext); í 
encoding mr EB! 
12) 


console- Tod (t); 


同时 ， 我 们 也 要 将 这 个 downLoad 函数 作为 参数 传递 给 analyze 模块 的 findImeg 方法 ， 最 
后 运行 这 个 项 目的 主 函 数 start0， 这 样 项 目 才 会 运行 起 来 。index.js 文件 中 的 完整 代码 如 下 : 


var fs = require('fs'); 

const request = require ('request'); 
const path = require ('path');/ 

const config = require ('./config'); 
const analyze = require ('./analyze'); 


Function sSCarE) ed 
request (config-url; function(err, res; body) f 
console log SEAC): 
if(!err && res) { 
console -logi start. y; 
analyze .findImg (body, download ]) ; 


Funetion downLoad ( imol)r l a] 
Tet ext = imgurhb spirit (" r) popii: 
request (imgUr1) .pipe (fs.createWriteStream(path.join(config.imgDir, i + '.' + 
estie l 
encoding tu L FB? 
J) 


consolestlog(l Get a Fr 3 r mi pic s5mimn) 


Start); 
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4.5.7 ”局 动 项 目 


利用 命令 行 运行 mdex.js 文件 便 可 以 局 动 这 个 项 目 了 ， 局 动 后 可 以 看 到 控制 台 输 出 的 调试 
信息 如 图 4.16 所 示 。 


Nodejs command prompt 


4.16 控制 台 输 出 的 调试 信息 
代码 运行 一 段 时 间 后 ， 可 以 在 img 文件 夹 中 找到 那些 保存 的 图 片 ， 具 体 如 图 4.17 所 示 。 


图 4.17 疏 取 的 图 片 结果 


这 里 只 是 演示 了 最 基本 的 爬 取 图 片 并 保存 的 代码 。 如 前 文 所 述 , 如 果 读 者 需要 精确 保存 需 
要 的 图 片 ， 就 要 对 DOM 结构 进行 更 加 详细 的 分 析 。 


L Ó 温 故 知 新 
学 完 本 章 ， 读 者 需要 回答 : 


1. 如 何 通过 NPM 下 载 第 三 方 模块 ? 

2. 如 何 生成 一 个 package.json 文件 ? 

3. package.json 文件 有 哪些 主要 的 字段 ， 分 别 代表 什么 意思 ? 
4. Node.js 如 何 导 出 和 引入 模块 ? 

5. Node.js 的 核心 模块 主要 有 哪些 ， 分 别 有 哪 些 常用 的 方法 ? 


és 


文件 的 操作 在 Node.js 的 编程 中 非常 重要 。Node.js 可 以 跨 平 台 运 行 ， 所 以 在 处 理 文件 的 操 
作 时 需要 考虑 不 同 操作 系统 的 区 别 。Node.js 同时 提供 大 量 核心 的 API 和 外 部 模块 供 开 发 人 员 
轻松 地 进行 文件 的 读 写 和 其 他 操作 ， 并 以 高 效率 著称 。 本 章 将 深入 讨论 如 何在 Node.js 中 使 用 
这 些 模块 来 完成 文件 操作 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


文件 路 径 : 学 会 如 何 处 理 文件 的 路 径 和 从 文件 路 径 中 获取 信息 .。 
打开 和 关闭 文件 : 学 会 如 何 打 开 一 个 已 存在 的 文件 和 在 文件 操作 结束 后 正常 关闭 文件 。 
读 写 文件 : 学 会 如 何 使 用 Node.js 包 读 取 和 写 入 纯 文本 文件 、XML 文件 、CSV 文件 
和 JSON 文件 。 

o 文件 操作 的 组 合 应 用 通过 本 章 最 后 的 实例 演示 如 何 组 织 从 文本 文件 中 读 取 数 据 并 修 
改 数据 格式 重新 生成 对 应 的 CSV 文件 。 


E 本 章 内 容 不 包含 对 数据 库 的 操作 。 


Node.js 文件 系统 介绍 


Node.js 为 文件 操作 提供 了 大 量 的 API。 这 些 API 基本 上 和 UNIX (POSIX) 中 的 API 相 
对 应 。Node.js 在 操作 文件 时 使 用 的 是 全 (file system, HRA) 模块 。 文 件 系统 模块 有 两 种 
不 同 的 方法 ， 分 别 是 异步 和 同步 。 


5.1.1 同步 和 卉 步 


为 了 使 用 Node.js 进行 文件 操作 ， 首 先 要 使 用 require('fs") 来 加 载 文件 系统 模块 。 异 步 方 法 
的 最 后 一 个 参数 是 一 个 完整 的 回调 函数 (callback 图 数 ) 。 传 递 给 回调 函数 的 参数 一 般 取 决 于 
这 个 方法 本 号, 但 是 第 一 个 参数 永远 是 异常 (err) 。 如 果 方 法 执行 成 功 ， 第 一 个 参数 将 会 是 
null 或 者 undefined。 当 使 用 同步 方法 来 执行 时 ， 任 何 异 第 都 会 立刻 引发 。 我 们 可 以 使 用 try 或 
者 catch 来 处 理 寞 常 并 将 错误 信息 显示 出 来 。 

下 面 给 出 一 个 异步 方法 的 例子 ， 其 中 tmp 文件 夹 下 有 一 个 hello 文件 。 
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【示例 5-1] 


const fS "require 人 ES 


/ /异步 操作 读 取 文 件 
Es umnlink( Ea/hello {err} > I 

IE err) CHFOW Err; 

console.log ('successfully deleted ./tmp/hello'); 
Hi: 


【代码 说 明 】 
这 段 代 码 将 删除 在 tmp 目录 下 的 hello 文件 ， 如 果 删 除 成 功 ， 就 在 console 中 打印 删除 成 功 的 
信息 。 也 可 以 使 用 同步 的 方法 实现 同样 的 功能 。 下 面 的 代码 将 使 用 同步 的 方法 执行 相同 的 操作 : 


const fs = require('fs'); 


// 同 步 操作 读 取 文 件 
fs.unlinkSync(" ./tmp/hello'"); 
console.log ('successfully deleted /tmp/hello'); 


异步 操作 的 方法 不 能 保证 一 定 执行 成 功 ,所 以 文件 操作 的 顺序 在 代码 执行 过 程 中 是 非常 重 
要 的 ， 例 如 下 和 面 的 代码 将 会 引发 一 个 错误 。 


【示例 5-2】 
// 重 命名 hello 文件 为 world 文件 
fs.rename ('./tmp/hello', './tmp/world', (err) => í 
IEA lerr) teow err; 
console.log ('renamed complete');) 
} ) 
// 获 取 world 文件 的 信息 
fs stall" /LCmpiworids lerr; Stats) > f 
if (err) throw err; 
console: log stats: S[JSON.sStringify(stats)i ); 
}); 


fs.stat 将 在 fs.rename 之 前 执行 ， 正 确 的 方法 是 使 用 回调 函数 来 执行 。 下 面 的 代码 是 正确 
使 用 回调 函数 来 处 理 程序 执行 过 程 中 的 异常 : 


fs. rename(" ./tmp/hello"', "./tmp/worid", (err) = I 
Filer throw err: 
Ts. stat (" /Ltmp/wocidi, lerr, stars) = I 
if (err) throw err; 
console.log stats: STIJSON:`sSEringi1fvy (Stats) ) ); 
H: 
}); 


P. 在 一 个 大 型 的 系统 中 ， 建 议 使 用 异步 方法 ， 同 步 方法 将 会 导致 进程 被 锁 死 。 和 同步 方法 相 
| 比 ， 异 步 方 法 性 能 更 高 、 速 度 更 快 ， 而 且 阻 塞 更 少 。 本 书 以 介绍 异步 方法 为 主 ， 同 步 方法 
为 辅 。 
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5.1.2 fs 模块 中 的 类 和 文件 的 基本 信息 


Node js 在 文件 模块 中 只 有 4 AŽ, TAA fs.FSWatcher、fs.ReadStream、fs.Stats 和 
fs.WriteStream。 其 中 ，fs.ReadStream 和 fs.WriteStream 分 别 是 读 取 流 和 写 入 流 ， 我 们 将 在 后 面 
的 内 容 中 进行 介绍 ; fs.FSWatcher 和 fs.Stats 可 以 获取 文件 的 相关 信息 。 

stats 类 中 的 方法 有 : 


stats.isFile(): 如 果 是 标准 文件 就 返回 tue， 如 果 是 目录 、 套 接 字 、 符 号 连接 或 设备 等 
就 返回 false。 

stats. isDirectory(): 如 果 是 目录 就 返回 true, 

stats. isBlockDevice(): 如 果 是 块 设备 就 返回 tue。 大 多 数 情况 下 ， 类 UNIX 系统 的 块 
设备 都 位 于 /dev ARF. 

stats. isCharacterDevice(): 如 果 是 字符 设备 就 返回 true, 

stats. isSymbolicLinkO: 如 果 是 符号 连接 就 返回 true。fs.lstat(0) 方 法 返回 的 stats 对 象 才 
有 此 方法 。 

stats.isFIFO(): 如 果 是 FIFO 就 返回 true, FIFO 是 UNIX 中 一 种 特殊 类 型 的 命令 管道 。 
stats. isSocket(): 如 果 是 UNIX 套 接 字 就 返回 true. 


使 用 fsstatO. fs.statO# fs.fstat0 方 法 都 将 返回 文件 的 一 些 特征 信息 ， 如 文件 的 大 小 、 创 
建 时 间或 者 权限 。 一 个 典型 的 查询 文件 元 信息 的 代码 如 下 : 


【示例 5-3] 


var fs = require('fs'); 


fs Stat ('5 3:JS function lerr; Stats) 
console.log (stats); 


}) 


运行 上 和 面 的 代码 ， 将 会 输出 如 图 5.1 所 示 的 文件 信息 。 
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5.1.3 文件 路 径 


在 Nodejs 中 , 访问 文件 既 可 以 使 用 相对 路 径 又 可 以 使 用 绝对 路 径 。 我 们 可 以 使 用 path 模 
块 功能 来 修改 链接 、 解 析 路 径 ， 还 可 以 对 路 径 进行 转换 和 规范 化 。 需 要 注意 的 是 ， 不 同 操作 系 
统 的 路 径 分 隔 也 不 一 样 ， 如 有 的 需要 融 “/”， 有 的 不 需要 。 因 此 ， 处 理 文件 路 径 会 比较 困难 ， 
使 用 path 模块 可 以 很 好 地 解决 这 些 问 题 。 

使 用 path 模块 时 ， 首 先 要 用 require(path) 进 行 引 用 。path 模块 主要 有 以 下 几 个 主要 功能 : 


e 规范 化 路 径 。 

@ 连接 路 径 。 

e 路 径 解 析 。 

@ 查找 路 径 之 间 的 关系 。 
@ 提取 路 径 中 的 部 分 内 容 。 


下 面 的 代码 使 用 nomrmalize0 方 法 来 规范 化 路 径 字 符 串 , 在 存储 和 使 用 路 径 之 前 将 其 规范 化 
可 以 避免 之 后 的 错误 引用 。 


var path = require(('path'); 
path.normalize('/chapter05//tmp/asdf/quux/..'); 


// 处 理 后 
'/ chapter05/tmp/asdf' 


join0 方 法 可 以 连接 任意 多 个 路 径 字 符 串 。 要 连接 的 多 个 路 径 可 作为 参数 传 入 。 下 面 给 出 
一 个 路 径 连接 的 示例 。 


【示例 5-4] 
var path = require ('path'); 
// 合 法 的 字符 串 连接 
path. oin( ehanter0s En asd EYOU 二 站 
// 连接 后 
'/chapter05/tmp/asdf' 


// 不 合法 的 字符 串 将 抛 出 异常 
path.join("'/chapter05"*, {}; "imp') 
// 抛 出 的 异常 


TypeError: Arguments to path.join must be strings' 

【代码 说 明 】 

path_relative(0 方 法 可 以 找 出 一 个 绝对 路 径 到 另 一 个 绝对 路 径 的 相对 关系 。 例 如 ， 下 面 的 代 
码 判定 两 个 路 径 的 相对 关系 ， 结 果 将 得 出 为 .…/.../zxcv '。 


var path = require('path');/ 
path.relative('/chapter05/tmp/asdf', '/chapter05/tmp/zxcv');/ 
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Er 在 使 用 相对 路 径 的 时 候 ， 路 径 的 相对 性 应 该 与 process cwdO 一 致 。 


基本 文件 操作 


Node.js 使 用 流 (stream ) 的 方式 来 处 理 文 件 。 这 种 处 理 方式 和 处 理 网 络 数据 几乎 是 一 样 的 ， 
操作 起 来 非常 方便 ,使 用 流 的 方式 操作 一 般 会 有 一 个 问题 , 即 无 法 在 文件 的 指定 位 置 进 行 读 写 。 
但 是 Node.js 进行 了 更 底层 的 操作 ， 除 了 可 以 在 文件 的 尾部 写 入 数据 外 ， 也 可 以 在 文件 的 特定 
位 置 写 入 数据 。 

Node.js 中 有 丰富 的 API 文 持 对 文件 的 各 种 操作 ， 包 括 获取 文件 信息 、 创 建 和 删除 文件 、 
打开 和 关闭 文件 、 读 写 数据 。 在 本 节 中 将 会 介绍 文件 的 一 些 基 本 操作 ， 下 一 节 会 针对 具体 格式 
的 文件 操作 进行 讲解 。 


5.2.1 打开 文件 


在 处 理 文件 之 前 都 需要 使 用 Node. js 中 的 fs.open 方法 来 打开 文件 ,然后 才能 使 用 文件 描述 
从 调用 所 提供 的 回调 函数 。 在 腊 步 模式 下 打开 文件 的 语法 如 下 : 


fs.open (path, flags[, mode], callback) 


参数 使 用 说 明 如 下 : 


© path: 文件 的 路 径 。 

© flags: 文件 打开 的 方式 ， 具 体 说 明 可 参见 表 5-1. 

© mode: 设置 文件 模式 (权限) ， 文 件 创建 默认 权限 为 可 读 写 
© callback: 回调 函数 ， 同 时 带 有 两 个 参数 。 


表 5-1 fs.open 中 flag 参数 说 明 


fm — I I 
LO SERNAM, 如 果 文件 不 存在 , Rhus ° — 
m [Db at: O — 


Ww | 以 号 入 模式 打开 文件 , 如果 文件 不 存在 , 就 他 建 OOO 
We | 类 似 w, 但 着 文件 路 生存 在 , 则 文 作 SXX 败 — ° 
| 以 追加 模式 打开 文件 , 如 果 文件 不 存在 , 就 盾 — — 
a [A EERE, WAREM OO 
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下 面 的 代码 将 打开 一 个 文件 ， 并 在 打开 之 前 和 成 功 打 开 之 后 在 console 中 显示 相对 应 的 消息 。 
【示例 5-5] 


var fs = require("fs!); 


H 打开 文件 
console.log ("准备 打开 文件 1"); 
ES OPEN text EXE Tr netlienlernn ë Ed) 
TF O = sh | 
Fe PITI ein 


) 
console.log ("RIEF XCF!" ; 
i); 


5.2.2 关闭 文件 


关闭 文件 将 使 用 fs.close 和 fs.closeSync 方法 。 其 中 ，fs.closeSync 为 同步 操作 的 方法 。 我 
们 在 这 里 主要 介绍 使 用 异步 的 fs.close 方法 。 它 一 共有 两 个 参数 可 以 设 定 ， 具 体 语 法 如 下 : 


fs_`close(Ed, callback) 
参数 使 用 说 明 如 下 : 


© fd: 通过 fs.open() 方 法 返回 的 文件 描述 符 。 
© callback: 回调 函数 ， 没 有 参数 。 


在 实际 的 开发 过 程 中 ， 如 果 打 开 了 一 个 文件 ， 束 应 该 在 文件 操作 完成 之 后 尽快 关闭 该 文 
件 ， 为 此 可 能 需要 跟踪 那些 已 经 打开 的 文件 描述 得， 并 在 操作 完成 之 后 确保 文件 正确 关闭 。 下 
面 的 代码 将 建立 一 个 新 的 文本 文件 ， 并 进行 打开 文件 和 关闭 文件 的 操作 。 


【示例 5-6】 


var fs = require (`fs'); 


console.1og ("准备 打开 文件 !"); 
Fs open- Input- Ex Ertl efFuneEeionterr erdi 
Te 
return Console.error (err); 
} 
console.log ("文件 打开 成 功 !"); 


// 关闭 文件 
fsichose(Fol function lerri] 
ITER(CET) 1 
console.log (err); 


} 
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console.1og ("文件 关闭 成 功 !"); 


J); 


J]; 


【代码 说 明 】 
事实 上 ， 并 不 需要 经 常 使 用 fs.close 来 关闭 文件 。 除 了 几 种 特例 之 外 ，Node.js 在 进程 退出 
之 后 将 自动 把 所 有 文件 关闭 。 原 因 在 于 ， 在 使 用 fs.readFile、fs.writeFile 或 fs.append 之 后 ， 它 
们 并 不 返回 任何 fd, Node.js 将 在 文件 操作 之 后 进行 判断 并 上 自动 关闭 文件 。 例 如 ， 在 执行 下 面 
的 代码 后 并 不 需要 使 用 fs.close 来 关闭 文件 。 
var fs = require('fs'); 


// 在 /home/text .txt 中 写 入 字符 串 abc 


fs. writeFile("/home/text.txt","abc"); 


在 使 用 一 些 方法 的 时 候 ， 例 如 fs.createReadStream, Æ option 中 有 autoClose 选项 ， 之 后 在 


autoClose 选项 设置 为 true 的 时 候 才 会 在 文件 操作 之 后 自动 关闭 ， 详 细 内 容 请 参见 相关 方 
法 的 具体 说 明 或 Node.js 的 官方 手册 。 


5.2.3 读 取 文 件 


Node.js 目前 支持 UTF-8、UCS2、ASCII、Binary、Base64、Hex 编码 的 文件 ， 并 不 支持 中 
X GBK 或 GB2312 之 类 的 编码 ， 所 以 无 法 操作 GBK 或 GB2312 格式 文件 的 中 文 内 容 。 如 果 
想 读 取 GBK 或 GB2312 格式 的 文件 , 需要 第 三 方 的 模块 支持 建议 使 用 iconv 模块 或 iconv-lite 
模块 。 其 中 ，iconv 模块 仅 支 持 Linux， 不 支持 Windows. 

在 Node.js 中 读 取 文件 一 般 使 用 fs.read 方法 。 该 方法 从 一 个 特定 的 文件 描述 符 (fd) 中 读 
取 数 据 ， 语 法 格式 如 下 : 


fs.read (fd, buffer, offset, length, position, callback) 
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参数 使 用 说 明 如 下 : 
© fd: 通过 fs.open() 方 法 返回 的 文件 描述 符 。 


buffer: 数据 写 入 的 缓冲 区 。 

offset: 缓冲 区 写 入 的 写 入 偏 移 量 。 

length: 要 从 文件 中 读 取 的 字 节 数 。 

position: 文件 读 取 的 起 始 位 置 ， 如 果 position 的 值 为 null， 就 会 从 当前 文件 指针 的 位 
置 读 取 。 

callback: 回调 函数 ,有 err、bytesRead、buffer 三 个 参数 ,其 中 err 为 错误 信息 ,bytesRead 
表示 读 取 的 字 节 数 ，buffer 为 缓冲 区 对 象 。 


下 面 的 代码 是 一 个 文件 读 取 的 示例 。 首 先 ， 使 用 fs.open0 方 法 将 文件 打开 ; 然后 ， 从 第 
100 个 字 节 开始 ， 读 取 后 面 的 1024 个 字 节 的 数据 ; 读 取 完 成 后 ，fs.openO 会 使 用 回调 方法 返回 
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数据 ， 再 处 理 读 取 到 的 缓冲 数据 。 
【示例 5-71 


var fs = require('fs'); 


rS. operm( (15 -JS Ari EUNE VON Err; td 
var readBuffer = new Buffer (1024), 
offset = 0, 
len = readBuffer.length, 
t deposit rom T LOOS 
fs.read(fd, readBuffer, offset, len, filePostion, function(err, readByte)t 
console.1log (' 读 取 数据 总 数 : ，' +readByte+' bytes' ); 
// ==> 读 取 数据 总 数 
console.log (readBuffer.slice(0，，readByte));// 数 据 已 被 填充 到 readBuffer 中 
J) 


读 取 文件 也 可 以 使 用 fs.readFile0 方 法 ， 语 法 格式 如 下 : 


fs.readFile (filename[, options], callback) 


© filename: 要 读 取 的 文件 。 

© options: 一 个 包含 可 选 值 的 对 象 。 
> encoding {String | Null? 默认 为 null。 
> flag {String} RUAT. 

@ callback: 9J] Až. 


fs.readFile 方法 是 在 fs.read 上 的 进一步 封装 ， 两 者 的 主要 区 别 是 fs.readFile 方法 只 能 读 取 
文件 的 全 部 内 容 。 


P js 文件 必须 保存 为 UTF8 编码 格式 。 使 用 Nodejs 开发 时 ， 无 论 是 代码 文件 还 是 要 读 写 的 


其 他 文件 ， 都 建议 使 用 UTF8 编码 格式 保存 ， 这 样 无 须 额外 的 模块 支持 。 


524 与 入 文件 


写 入 文件 一 般 使 用 fs.writeFile 和 fs.appendFile 方法 ,两 者 都 可 以 将 字符 串 或 者 缓存 区 中 的 
内 容 直 接 写 入 文件 ， 如 果 检 测 到 文件 不 存在 ， 右 创建 新 的 文件 。fs.writeFile 和 fs.appendFile 的 
语法 格式 也 非常 接近 ， 分 别 如 下 : 


(1) fs.writeFile 语法 : 
fs.writeFile (filename, datal[l, options], callback) 


参数 使 用 说 明 如 下 : 
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© filename: 文件 名 或 文件 描述 符 。 

data: 写 入 文件 的 数据 ， 可 以 是 字符 串 (String) 或 流 (Buffer) 对 象 。 

© options: 该 参数 是 一 个 对 和 象 ， 包 含 {fencoding, mode, flag}, RUAA UTF8， 模 式 为 
0666, flag 2b 'w'. 

@ callback: 回调 函数 ， 只 包含 错误 信息 参数 (er). 


(2) fs.appendFile 语法 : 

fs.appendFile (file, data[, options], callback) 

参数 说 明 如 下 : 

@ file: 文件 名 或 者 文件 描述 符 。 
data: 可 以 是 字符 串 或 流 对 象 。 
options: 该 参数 是 一 个 对 名， 包含 {encoding, mode, flag}， 默 认 编 码 为 UTF8， 模 式 为 
0666, flag 为 'w'。 
@ callback: 回调 函数 ， 只 包含 错误 信息 参数 ler). 
下 面 将 字符 串 和 流 作 为 数据 源 写 入 一 个 文件 中 。 

【示例 5-8] 


var fs = require ('fs'); 


// 使 用 string 写 入 文件 
var str = new String('data to append' ) ; 


fs.appendFile ('message.txt', "data to append', 'utf8', callback); 


// 使 用 Buffer 写 入 文件 
var buf = new Buffer.from('data to append'); 
fs.appendFile ('message.txt', buf, (err) => { 
if (err) throw err; 
console.log ('The "data to append" was appended to file!'); 
1); 


【代码 说 明 】 
在 执行 写 入 文件 之 后 不 要 使 用 提供 的 缓存 区 , 因为 一 旦 将 其 传递 给 写 入 函数 , 缓存 区 就 处 
于 写 入 操作 的 控制 之 下 ， 直 到 函数 结束 之 后 才 可 以 重新 使 用 。 


e 在 写 入 文件 时 一 般 要 包含 号 入 信息 的 具体 位 置 ， 以 追加 模式 打开 文件 的 ,文件 的 游标 位 于 
| 文件 的 尾部 ， 因 此 写 入 的 数据 也 位 于 文件 的 尾部 。 
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利用 async_hooks 跟 蹊 异步 请 求 和 处 理 


Node.js 本 质 上 是 一 种 单线 程 的 语言 ,但 单线 程 并 不 意味 着 Node 进程 中 真 的 仅仅 包含 一 个 
线程 。 一 般 来 讲 ， 在 Node 进程 中 只 有 一 个 主线 程 用 于 人 处理 业务 逻辑 ， 而 其 余 线程 用 于 文 持 异 
z IO 功能 ， 因 此 也 被 称 为 IO 线程 。IO 线程 主要 用 于 接收 主线 程 的 IO 事件 请 求 ， 然 后 发 起 
IO 调用 ， 并 将 IO 调用 的 结果 传递 到 主线 程 。 

那么 , Node.js 如 何 跟踪 异步 请 求 和 处 理 就 显得 尤为 重要 了 。 在 早期 的 Nodejs 版 本 中 提供 
一 些 原 生 方 法 〈 比 如 AsyncListener 功能 ) ， 另 外 还 有 Node 开发 社区 提供 一 些 第 三 方 插件 ， 对 
跟踪 Node 异步 请 求 和 处 理 做 了 很 好 实现 。 但 是 ， 这 些 方法 或 多 或 少 都 有 缺陷 ， 而 且 规范 上 也 
不 统一 。 
有 设计 需求 自然 就 会 推动 技术 进步 ， 从 Node.js 第 8 版 开始 提供 了 一 个 实验 性 的 功能 
async hooks 模块 ， 实 现 了 一 个 用 于 注册 回调 函数 的 API, 可 追踪 在 Node.js 应 用 中 创建 的 异步 
资源 的 生命 周期 。 

async_hooks 模块 提供 了 创建 跟踪 Node 异步 请 求 和 处 理 的 方法 (createHook()) ， 下 面 简 
单 介 绍 一 下 : 


async hooks. -createHooklcal loacks) 


createHook 方法 主要 用 于 注册 一 系列 回调 函数 , 这 些 回 调 函 数 会 在 异步 操作 的 各 个 生命 周 
期 的 事件 中 被 调用 。 回 调 了 浮 数 (callbacks〉 包含 init0、before0、after0 和 destroyO 业 务 方法 ， 
一 般 这 4 个 方法 不 需要 全 部 使 用 ， 但 init0 方 法 一 般 是 必须 使 用 的 。 

1. init() 


init(asyncId, type, triggerAsyncId, resource) 


参数 说 明 : 


© asyncld<number>: 异步 资源 的 唯一 ID。 当 一 个 可 能 触发 异步 事件 的 类 初始 化 的 时 候 ， 
initO 方 法 将 会 被 调用 ， 然 而 随后 的 before()、after() 和 destroy0O 方 法 并 不 一 定 被 调用 。 
每 个 异步 资源 会 被 分 配 一 个 唯一 的 ID， 即 asyncId。 

© type<string>: 异步 资源 的 类 型 ， 这 是 Node.js 内 部 定义 好 的 ， 当 然 也 提供 了 自 定 义 的 


E 

© triggerAsyncId<number>: 创建 此 异步 资源 的 执行 上 下 文 的 唯一 ID， 即 此 资源 调用 链 
上 的 父 ID。 

@ resource<Object>: 一 个 代表 异步 资源 的 对 和 象 ， 可 以 从 此 对 和 象 中 获得 一 些 异 步 资 源 相 
关 的 数据 。 


2. before(asyncld ) 
before 回调 表示 当 一 个 异步 操作 初始 化 或 者 完成 时 所 对 应 的 回调 函数 将 被 调用 。asyncId 
表示 执行 回调 函数 的 异步 资源 的 唯一 ID。 理 论 上 异步 资源 的 回调 将 会 被 执行 零 次 或 者 多 次 ， 
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因此 before 回调 也 可 能 被 执行 零 到 多 次 。 

3. after(asyncld) 

after 回调 会 在 异步 资源 的 回调 被 执行 之 后 立即 调用 。 

4. destroy(asyncld) 

当 asyncId 代表 的 资源 被 销毁 的 时 候 ，destrory 回调 被 调用 。 

下 面 看 一 个 具体 使 用 async hooks 模块 的 代码 示例 ， 相 信 读 者 对 console.log0 方 法 非常 熟 
悉 ， 因 此 没有 过 多 关注 该 方法 。 其 实 ，consolelog() 方 法 是 一 个 彻头彻尾 的 异步 方法 ， 在 控制 
台中 输出 的 内 容 都 是 异步 完成 的 。 下 面 的 代码 示例 将 使 用 async hooks 模块 跟踪 console.log( 
方法 的 异步 请 求 和 处 理 。 


【示例 5-9】 


"ise stricti"'; 


const fs = require('fs'); 


const asyncHooks = reqüire("async hooks'); 


const hook = asyncHooks.createHook({ 
init (asyncId, type, triggerAsyncId, resource) { 
fs writeSynec(T1 Minit: 
asyncId-$(asyncId),type-$(type),triggerAsyncId-$(triggerAsyncId)Nn'); 
} ， 
before (asyncId) { 
fs.writeSync (1l, 'before: asyncId-$(asyncId)Nn'); 


I> 
after (asyncId) { 
fs.writeSync (l, 'after: asyncId-S$(asyncId)Nn'); 


}, 
destroy (asyncīId) { 
fs.writeSync(1, 'destroy: asyncId-$(asyncId)Nn'); 


} 
}) .enable (); 


console log (ene 


console.log ({'asyne hooks"); 
【代码 说 明 】 
首先 要 使 用 require(async hooks) 引 用 async hooks 模块 ， 然 后 调用 createHook( 方 法 创建 
跟踪 Node 异步 请 求 和 人 处理 的 方法 , 在 createHook0 方 法 内 , 分 别 实现 了 对 initO、before()、afterO 
和 destroy0 业 务 方法 的 定义 。 最 后 ， 分 两 次 调用 console.log0 方 法 在 控制 台中 输出 不 同 的 文本 
信息 。 
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在 控制 台中 运行 该 Node 程序 ， 输 出 的 调试 信息 如 图 5.2 所 示 。 


Nodejs command prompt 


5.2 ”追踪 console.log0 方 法 的 异步 请 求 和 处 理 


从 图 5.2 中 可 以 看 到 , 两 个 console.log0 方 法 调用 的 父 级 ID 是 相同 的 , 但 两 个 console.log() 
方法 目 身 的 ID 是 不 同 的 。 同 时 根据 asyncId 值 判 断 ，init()、before()、after() 和 destroyO 这 4 个 
用 于 追踪 的 业务 方法 是 依次 被 调用 的 。 


" ~ £ I| Í [=] 
w @ 5 r 其 他 文件 操作 


在 实际 的 编程 过 程 中 ， 我 们 需要 操作 多 种 不 同 格 式 的 文件 。Node.js 除了 提供 官方 的 API 
对 文件 操作 进行 支持 外 ， 也 可 以 通过 NPM 安装 第 三 方 的 模块 来 进行 文件 的 操作 。 本 节 主 要 介 
绍 如 何 通 过 Node.js 和 第 三 方 模块 来 操作 ， 如 CSV 文件 、XML 文件 和 JSON 文件 。 本 节 我 们 
以 CSV 文件 为 例 来 详细 介绍 。 

CSV 是 一 种 常见 的 数据 格式 。Node.js 中 有 很 多 模块 可 以 解析 CSV 文件 ， 这 里 建议 搭建 使 
用 node-CSV 来 进行 文件 的 解析 操作 。node-CSV 遵循 开源 的 BSD 协议， 项目 在 Git 网 站 的 网 
址 为 https://github.com/wdavidw/node-CSV 。 它 一 共 包 含 4 个 包 ， 分 别 为 CSV-generate、 
CSV-parse、stream-transform 和 CSV-stringify。 各 个 包 的 功能 具体 如 下 : 


@ CSV-generate: 用 来 生成 标准 的 CSV 文件 。 

© CSV-parse: 将 CSV 文件 解析 为 数组 变量 。 

@ stream-transform: 一 个 转换 框架 。 

@ CSV-stringify: 将 记录 转换 为 CSV 的 文本 。 

使 用 node-CSV 时 ， 需 要 先 通过 npm 命令 来 安装 CSV 的 包 ， 有 具体 命令 如 下 : 


npm install csv 


其 中 每 个 包 都 与 stream2 和 stream3 的 标准 相 兼 容 ， 并 且 提 供 一 个 简单 的 回调 函数 。 
CSV-parse 解析 方法 可 以 使 用 多 种 选项 , 但 所 有 的 选项 都 是 可 选 的 , 而 不 是 必需 的 , 参见 表 5-2, 
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表 5-2 fs.open 中 的 flag 参数 说 明 


设 定 分 隔 符 ， 只 能 设 定 一 个 字符 ， 默 认为 "，， 


定义 行 分 隔 符 ， 默 认 值 为 auto， 也 可 以 设 定 为 mnix、mac、'windows'、 
'unicode' 

默认 为 双 引号 ， 可 以 用 来 限定 一 个 范围 

默认 值 为 Blse， 如 果 设置 为 tue， 就 将 忽略 分 隔 符 后 面 的 空格 

默认 值 为 false， 如 果 设 置 为 tue， 就 将 忽略 分 隔 符 后 面 的 空格 


IREME true, HEARRE ATER BON rative 类 型 
REN rue, ERRERA dais A 


下 面 的 代码 将 使 用 CSV 模块 中 的 stream 来 读 取 、 解 析 和 转换 CSV 文件 。 
【示例 5-10】 


var CVS eguare ESVW 


var generator = CSV.generate({seed: 1, columns: 2, length: 20}); 
var parser = CSV.parse () ; 
var transformer = C€SV transform(functTron(data) Í 

return data.map (function(value) (return value.toUpperCase () )) ; 
}); 


var Sstringilier =~ CSV stringity(); 


generator.on('readable', function(){ 
while (data = generator.read()) Í 
parser: writoedatra); 
} 
I); 
// 解 析 生 成 的 csv 文件 
parser Onr eadable r S rurncteiorihi 
while (data = parser.read()){ 
Lranstormer.write (data); 


) 


86 


第 5 章 文件 系统 


}); 
// 将 csV 文件 转换 为 txt 文件 
EranstEormersorn( creadable ee FuncecEeroen(yl 
while (data = transformer.read()){ 
stringifier.write (data); 
) 
)); 


Sering rer on readable uneeronl 
while (data = stringifier.read()){ 
process sStcjoÓni Sur ri darah 
} 
} ) ; 


【代码 说 明 】 
首先 要 使 用 require('csv") 引 用 csv 模块 ， 引 用 之 后 ， 就 可 以 直接 使 用 它 封 装 的 方法 和 属性 
了 。csv0 相 当 于 实例 化 一 个 对 象 ，.ffom 和 .to 都 是 csv 封装 的 方法 。 
@ from02 k: 从 源 文件 中 读 取 数据 ， 参 数 既 可 以 直接 传 字符 串 ,， 又 可 以 传 源 文 件 的 路 
径 。 
© .to( 方 法 : 将 从 form 方法 中 读 取出 来 的 数据 输出 ， 既 可 以 输出 到 控制 台 ， 又 可 以 输 
出 到 目标 文件 。 此 例子 是 输出 到 控制 台 。 


实战 一 一 用 IP 地 址 来 查询 天 气 情 况 
本 节 将 利用 本 章 所 介绍 的 文件 操作 方法 实现 一 个 完整 的 实例 。 


5.5.1 项 目 思路 


从 一 个 JSON 格式 的 文件 中 读 入 IP 地 址 ， 利 用 开放 的 GEO 服务 将 IP 地 址 转换 为 城市 的 
名 称 ， 并 将 城市 当天 的 天 气 信息 输出 到 一 个 新 的 JSON 文件 。 读 取 的 JSON 文件 格式 如 下 列 代 
码 所 示 。 

// 读 取 的 JSON 文件 格式 ， 每 个 为 标准 的 IP 地 址 


站 
6072092215 41591 


要 求 输出 的 文件 格式 如 下 : 


// 输 出 的 文件 格式 IP 地 址 、 天 气 状 况 、 城 市 名 称 

[ 

L zip: lo29230-.208 ~ weather Cloudssr I reqlion : SAhejiang: t; 
epa: 0 Ld L322 30 7 ewWeatheri: C Clears; regioni: = Shanghais, 
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IT i pus ES 1125 2351224" S "weather" Raln i regions: E Californian y 
1 二 下 本 551 239 200 .98 -weather :oo Clonmndsi i reglion :Czech j; 
I 60290 215 T 5=# n weathner .Clear regqLlone -0 Emacs 


] 
整体 的 思路 是 : 首先 通过 fs 模块 读 取 JSON 文件 中 的 内 容 ， 通 过 JSON.parse 解析 IP Hih 


的 信息 ， 根 据 IP 地 址 获取 城市 的 名 称 和 当地 实时 的 天 气 信息 。 最 后 将 所 有 的 信息 重新 组 织 ， 
并 输出 到 一 个 新 的 JSON 文件 weather.json。 


5.5.2 引入 基础 模块 


如 前 和 面 章 节 介 绍 的 , 在 进行 文件 操作 之 前 ,首先 要 引入 必要 的 模块 。 下面 的 代码 用 require 
引入 了 我 们 所 需要 的 所 有 模块 : 
// 引 入 基础 模块 


var fs = require('fs') 
var request = require ('request') 
var gs. = recuire ("cyurerystit ring") 


这 里 我 们 引入 了 3 个 模块 ， 分 别 为 : 


(1) fs: 从 文件 ip.json EE P 列表 ， 把 结果 写 入 文件 中 。 
(2) request: 用 来 发 送 HTTP 请 求 ， 根 据 IP 地 址 获取 GEO 数据 ， 再 通过 GEO 数据 获取 


(3) querystring: 用 来 组 装 发 送 请 求 的 URL 参数 。 


5.5.3 ”解析 IP 地 址 信息 


这 里 通过 调用 fs.readFile 读 取 文件 中 的 IP 列表， 再 通过 我 们 前 面 介绍 的 JSON.parse 解析 
JSON 数据 ， 代 码 如 下 : 
// 通 过 JSON. parse 解析 IP 列表 中 的 地 址 


function readIP (path, callback) { 
fs.readFile (path, function(err, data) { 
T rr (Sr) ET 
callback(lerr) 
} else {ċ{ 
try | 
data = JSON.parse (data) 
callback (null, data) 
F eatceh error) f 
callback (error) 
] 
} 
]) 
) 


88 


第 5 章 文件 系统 


5.5.4 通过 公共 服务 获取 城市 和 天 气 信息 


下 面 我 们 首先 用 IP 地 址 查询 相应 的 城市 名 称 ， 这 里 需要 利用 telize.com 的 公共 GEO 查询 
服务 。telize 是 一 个 基于 Nginx 和 Lua 构建 的 REST API， 人 允许 根据 IPv4 和 IPv6 的 地 址 查询 所 
在 地 区 信息 。 在 这 里 我 们 输出 JSON 封装 的 他 地 理 位 置信 息 ,telize 同时 也 支持 JSON 和 JSONP 
格式 的 输入 。 下 面 的 代码 将 用 IP 地 址 来 得 询 地 理 信 息 和 天 气 情 况 。 

// 通 过 telize 的 公共 GEoO 服务 来 获取 城市 信息 


function D2gqeolipr callbacke) i 
var url = 'http://www.telize.com/geoip/' + ip 
request ({ 
Dr [aqa a I 
Json: true 
Jy fFunctionlerr,; respr Dody) | 
callback(err, body) 
}) 


} 
// 通 过 openweathermap 的 公共 服务 来 获取 当地 的 天 气 信息 
function geo2weather(lat, lon, callback) { 
var params = { 
Lat: at, 
ton: Con; 


//public key 是 从 openweathermap 申请 的 开发 人 员 的 唯一 key 
APPTD: "public key" 
l 
var url = 'http://api.openweathermap.org/data/2.5/weather?' + 
qs.stringify (params) 
request ({ 
trr [ren uri; 
Json: Erie; 
f}; Eunctron(err, resp; body) f 
callback (err, body) 
I) 
) 


OpenWeatherMap 服务 提供 了 免费 的 天 气 数 据 和 预测 API， 如 包含 当前 天 气 的 地 图 、 一 周 
预报 、 降 水 、 风 、 云 等 来 自 气象 站 的 其 他 数据 ， 并 且 OpenWeatherMap 每 天 从 全 球 超 过 40 000 
个 气象 站 接收 气象 广播 服务 数据 。 

本 例 中 使 用 OpenWeatherMap 服务 的 API 来 获取 任意 的 天 气 数 据 。 其 他 类 别 的 应 用 也 可 以 使 
用 OpenWeatherMap 作为 天 气 数据 源 ， 数 据 可 以 从 WMS 服务 器 接收 并 可 以 被 敬 入 任何 基于 Web 
的 应 用 程序 中 。 更 多 详细 信息 请 参考 OpenWeatherMap 官方 网 址 : http://openweathermap.org/。 


e 本 节 的 代码 中 有 一 个 APPID， 做 过 微 信 开发 的 读者 肯定 都 知道 ， 这 是 一 个 开发 者 ID, 
| 本 例 中 的 APPID 是 从 OpenWeatherMap 申请 的 开发 者 ID ， 申 请 过 程 可 参考 
https://openweathermap.org/appid 
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5.5.5 WJ IP 地址 


截至 目前 , 我 们 通过 公共 服务 已 经 获取 到 地 理 信息 和 天 气 信 息 的 接口 , 接 下 来 我 们 还 要 处 
理 多 个 IP 地 址 ， 所 以 需要 并 行 地 读 取 地 理 位 置 并 读 取 相 对 应 城市 的 天 气 数据 。 下 面 的 代码 将 


完成 这 部 分 功能 。 
function geos2weathers (geos, callback) { 
var weathers = [| 
var geo 


var remain = geos.length 
for (var i- 0 < geos length: Iri) 
geo = geos [ 工 ] ; 
(function (geo) { 
geo2weather (geo.latitude, geo.longitude, function (err, weather) { 
if (err) { 
callback (err) 
} else { 
weather.geo = geo 
weathers .push (weather) 
remain-- 
) 
if (remain == 0) { 
callback (null, weathers) 
} 
I! 
}) (geo) 
} 
} 


geos2weathers 在 这 里 使 用 了 一 种 比较 简单 的 计算 方法 。remain 用 来 计算 等 待 返回 的 个 数 。 
remain 为 0 表示 并 行 请 求 结 束 ， 将 处 理 结 果 装 进 一 个 数组 返回 。 


5.5.6 ”将 结果 与 入 weather.json 
将 结果 写 入 weather.json 的 代码 如 下 ， 这 里 使 用 一 个 for 循环 裔 历 每 个 P 地 址 的 信息 。 


function writeWeather (weathers, callback) { 
var output = [] 
var weather 
// 使 用 for 循环 遍历 每 个 IP 地 址 的 信息 
for (var i = 0; i < weathers.length; i++) { 
weather = weathers[i] 
output ` push (I 
ip: weather.geo.ip, 
weather: weather.weather[0] .main, 
region: weather.geo.region 


} ) 
} 
// 使 用 fs .writeFile 函数 将 结果 写 入 weather.json 中 


fs.writeFile('./weather.json', JSON.stringify (output, null, ' '), callback) 


程序 运行 之 后 ， 生 成 的 weather.json 文件 如 图 5.3 所 示 。 
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输出 的 JSON 文件 可 以 通过 解析 输出 到 HTML 中 ， 最 终 在 应 用 程序 中 为 用 户 提供 实时 的 


地 理 位 置信 息 和 当地 的 天 气 情况 。 本 例 我 们 重点 介绍 前 半 部 分 ， 所 以 具体 如 何 显 示 类 似 图 5.4 


的 效果 ， 读 者 可 能 还 要 参考 一 些 HIML+CSS 的 技术 ， 这 里 不 再 提供 代码 。 
s [ 
3 "ip": "115.29.230.208", 


"weather": "Clouds", 
"region": "Zhejiang" 


"ip"; "180.153.132.387, 
"weather": "Clear", 
"region": "Shanghai" 


"mip a "759. 12522 2; 
"weather": "Rain", 
"region": "California" 


"fpr: 91 239. 253 ee 
"weather": "Clouds", 
"region": "Czech" 


s A a City of London, GB 


"weather": "Clear", 
"region": "Tianjin" 


* 8.6 °C 


53 生成 的 天 气 结果 JSON 文件 54 输出 效果 参考 图 


D.O 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 ; 


1. 打开 文件 和 关闭 文件 使 用 什么 方法 ? 

2. 异步 的 操作 有 哪些 优点 ? 

3. Node.js 是 否 可 以 操作 GBK 或 GB2312 格式 的 文件 ? 

4. 写 入 文件 有 哪 几 种 方法 ? 

5. 文件 读 取 失 败 有 哪 几 种 原因 ， 如 何 进 行 定位 ? 

6. 如 何 利用 async_hooks 模块 跟 踩 资源 的 异步 请 求 和 处 理 ? 

6. 创建 一 个 文件 ， 并 将 0~100 之 间 可 以 被 3 整除 的 数 写 入 该 文件 。 
7. 读 取 一 个 XML 文件 ， 并 将 其 转换 为 纯 文 本 文件 。 
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网 络 是 通信 互联 的 基础 , Node.js 提供 了 net, http. dgram 模块 , 分 别 用 来 实现 TCP. HTTP. 
UDP 的 通信 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

© TCP 服务 器 和 客户 端的 创建 。 

© HTTP 的 路 由 控制 思想 。 

@ UDP 数据 通信 的 实现 。 


构建 TCP 服务 器 


OSI 参考 模型 将 网 络 通信 功能 划分 为 7 层 ， 即 物理 层 、 数 据 链 路 层 、 网 络 层 、 传 输 层 、 会 
话 层 、 表 示 层 和 应 用 层 。TCP 协议 就 是 位 于 传输 层 的 协议 。Node.js 在 创建 一 个 TCP 服务 器 的 
时 候 使 用 的 是 net (网络 ) 模块 。 


6.1.1 使 用 Node.js 创建 TCP 服务 器 


为 了 使 用 Node.js 创建 TCP 服务 器 ， 首 先 要 使 用 require(net) 来 加 载 net 模块 ， 然 后 使 用 
net 模块 的 createServer 方法 就 可 以 轻松 地 创建 一 个 TCP 服务 器 。 


net.createServer([options] [, connectionListener]) 


© options 是 一 个 对 象 参 数值 ,有 两 个 布尔 类 型 的 属性 allowHalfOpen 和 pauseOnConnect。 
这 两 个 属性 默认 都 是 false。 

@ connectionListener 是 一 个 当 客 户 端 与 服务 端 建立 连接 时 的 回调 函数 , 这 个 回调 函数 以 
socket 端口 对 象 作为 参数 。 


构建 一 个 TCP 服务 器 的 代码 如 下 。 


【示例 6-1】 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 创 建 TCP 服务 器 */ 
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var server = net.createServer(function(socket) { 
console.log("'someone connects'); 


)) ; 


6.1.2 ”监听 客 尸 端的 连接 
使 用 TCP 服务 器 的 listen 方法 就 可 以 开始 监听 客户 端的 连接 : 
server.listen (port[,host] [;backlog] [, callback] ); 
@ port 参数 为 需要 监听 的 端口 号 ， 参 数值 为 0 的 时 候 将 随机 分 配 一 个 端口 号 。 
@ host 为 服务 器 地 址 。 


© backlog 为 连接 等 待 队列 的 最 大 长 度 。 
@ callback Z Jj y žk. 


如 下 代码 可 以 创建 一 个 TCP 服务 器 并 监听 18001 端口 。 


【示例 6-2】 
/* 引 入 net 模块 */ 


var net = require('net'); 


/* 创 建 TcP 服务 器 */ 
var server = net.createServer (function (socket) Í 
console.log ('someone connects'); 


I); 


/* 设 置 监听 端口 */ 
server. listen (18001, function) I 
console.log ('server is listening'); 


i: 
运行 这 段 代 码 ， 可 以 在 控制 台 看 到 执行 listen 方法 的 回调 函数 ， 如 图 6.1 所 示 。 


图 6.1 执行 listen 的 回调 函数 


可 以 使 用 相应 的 TCP 客户 端 或 者 调试 工具 来 连接 已 经 创建 的 这 个 TCP 服务 器 。 例 如 ， 要 
使 用 Windows 的 Telnet 就 可 以 用 以 下 命令 连接 : 


telnet localhost 18001 


连接 成 功 后 可 以 看 到 控制 台 打印 Y “someone connects” Ff, 表明 createServer 方法 的 回 
调 函 数 已 经 执行 ， 说 明 已 经 成 功 连接 到 这 个 创建 的 TCP 服务器， 如 图 6.2 所 示 。 


93 


Node js 10 实战 


Node.js command prompt - node 6-2.Js 
server is listening 


图 6.2 ”连接 到 TCP 服务 器 


server.listen() 方 法 其 实 触 发 的 是 server 下 的 listening 事件 ， 所 以 也 可 以 手动 监听 listening 
事件 。 如 下 代码 同样 实现 了 创建 一 个 TCP 服务 器 并 监听 18001 端口 的 作用 。 
【示例 6-3] 
/* 引 入 net 模块 */ 


var net = require ('net'); 


/* 创 建 TcP 服务 器 */ 
var server = net.createServer (function (socket) { 
console.log("'someone connects'); 


)); 


/* 设 置 监听 端口 */ 


server.listen(18001); 


/* 设 置 监听 时 的 回调 函数 */ 
server.on('listening', function (){ 
console.log ("server is listening'); 


)); 
除了 listening 事件 外 ，TCP 服务 器 还 文 持 以 下 事件 : 
© connection: 当 有 新 的 链接 创建 时 触发 ， 回 调 函 数 的 参数 为 socket 连接 对 象 。 
© close: TCP 服务 器 关闭 的 时 候 触 发 ， 回 调 函 数 没有 参数 。 
© error: TCP 服务 器 发 生 错 误 的 时 候 触发 ， 回 调 函 数 的 参数 为 error 对 象 。 
下 列 的 代码 通过 net.Server 类 创建 一 个 TCP 服务 器 ， 添 加 以 上 事件 。 
【示例 6-4] 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 实 例 化 一 个 服务 器 对 象 */ 


var server = new net .SerVer () 


/* 监 听 connection 事件 */ 
server.on('connection', function (socket) { 
console.log ('someone connects'); 


)); 
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/* 设 置 监听 端口 */ 


server.listen(18001); 


/* 设 置 监听 时 的 回调 函数 */ 
server.on('listening', function() { 
console.log ('server is listening');/ 


Fis 


/* 设 置 关闭 时 的 回调 函数 */ 
server.on('close', function() { 
console.log("'server closed'); 


)); 


/* 设 置 出 错时 的 回调 函数 */ 
server on("'!error";  functioní(err) I 
consoe og( error )ys 


Fs 


运行 以 上 这 段 代 码 并 用 Telnet 等 工具 连接 这 个 创建 的 TCP 服务 器 ， 可 以 发 现 效果 和 【 示 
B| 6-3】 代 码 的 效果 一 致 。 


6.1.3 ”查看 服务 器 监听 的 地 址 


当 创 建 了 一 个 TCP 服务 器 后 ， 可 以 通过 server.address(0) 方 法 来 查看 这 个 TCP 服务 器 监听 
的 地 址 ， 并 返回 一 个 JSON 对 象 。 这 个 对 象 的 属性 有 : 


@ port: TCP 服务 器 监听 的 端口 号 。 
© family: 说 明 TCP 服务 器 监听 的 地 址 是 IPv6 还 是 IPv4。 
@ address: TCP 服务 器 监听 的 地 址 。 
因为 这 个 方法 返回 的 是 TCP 服务 器 监听 的 地 址 信息 ， 所 以 这 个 方法 应 该 在 使 用 了 
server.listen() 方 法 或 者 绑 定 事件 listening 中 的 回调 函数 中 使 用 。 
【示例 6-5] 
/* 引 入 net 模块 */ 


var net = require('net');/ 
/* 创 建 服务 器 */ 
var server = net.createServer(function(socket) { 


console.log ("someone connects'); 


Ff); 


/* 设 置 监听 端口 */ 
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server. laisten (18001; EUNCCLONI) f 


/* 获 取 地 址 信息 */ 
var address = server.address () ; 

/* 获 取 地 址 端口 */ 
console.log('the port of server is ' + address.port); 
console logii Ehe address oSseryersee ee address address): 


console.log('the famaily of server is ' + address.family); 


|); 
运行 这 段 代 码 可 以 发 现 已 经 在 控制 台 打 印 出 TCP 服务 器 监听 的 地 址 信息 ， 如 图 6.3 所 示 。 


Node.js command prompt - node 6-5.js 
J p J 
> port of server is 18001 


> address of server is :: 
famaily of server is IPvó 


63 TCP 服务 器 监听 的 地 址 信息 


6.1.4 连接 服务 器 的 客户 痛 数 量 


创建 一 个 TCP 服务 器 后 ， 可 以 通过 server.getConnections() 方 法 获取 连接 这 个 TCP 服务 器 
的 客户 端 数 量 。 这 个 方法 是 一 个 异步 的 方法 ， 回 调 函 数 有 两 个 参数 : 


@ 第 一 个 参数 为 error 对 象 。 
@ 第 二 个 参数 为 连接 TCP 服务 器 的 客户 端 数量 。 
除了 获取 连接 数量 外 ， 也 可 以 通过 设置 TCP 服务 器 的 maxConnections 属性 来 设置 这 个 


TCP 服务 融 的 最 大 连接 数量 。 当 连接 数量 超过 最 大 连接 数量 的 时 候 ， 服 务 需 将 拒绝 新 的 连接 。 
如 下 代码 设置 创建 的 这 个 TCP 服务 器 的 最 大 连接 数量 为 3。 


【示例 6-6] 
/* 引 入 net 模块 */ 


var net = require ('net'); 


/* 创 建 服务 器 */ 
var server = net.createServer (function(socket) { 
console.log("'someone connects'); 
/* 设 置 最 大 连接 数量 */ 
Servenm mixCoannecerins E; 
server.getConnections (function(err, count) { 
console Tog Ehe count ot cellient Iis tr County; 


} ) 
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/* 设 置 监听 端口 */ 
server.listen(18001,function() í 


console.log("'server is listening'); 


}); 


运行 这 段 代码 ， 并 尝试 用 多 个 客户 端 连 接 。 可 以 发 现 当 客户 端 连接 数量 超过 3 的 时 候 ， 新 
的 客户 端 就 无 法 连接 这 个 服务 器 了 ， 如 图 6.4 所 示 。 


四 Node.js command prompt - node 6-6.js 


server is sige 
Bo of l ient JS f 


| “sedap anije BB la Z 
connects 


ba Goat SCO Tay i6 š 


图 6.4 设置 TCP 服务 器 的 最 大 连接 数量 


6.1.5 ”获取 客户 端 发 送 的 数据 


上 文 提 到 createServer 方法 的 回调 函数 参数 是 一 个 net.Socket 对 象 〈 服 务 器 所 监听 的 端口 
对 象 ) 。 这 个 对 象 同样 也 有 一 个 address(0) 方 法 ， 用 来 获取 TCP 服务 器 绑 定 的 地 址 ， 同 样 也 是 
返回 一 个 含有 port、family、address 属性 的 对 象 。 

socket 对 象 可 以 用 来 获取 客户 端 发 送 的 流 数据 , 每 次 接收 到 数据 的 时 候 触 及 data 事件 , 通 
过 监听 这 个 事件 就 可 以 在 回调 函数 中 获取 客户 端 发 送 的 数据 ， 代 码 如 下 : 

【示例 6-7] 
/* 引 入 net 模块 */ 


var net = require (('net'); 


/* 创 建 服务 器 */ 


var server = net.createServer(function(socket) { 


/* 监 听 data 事件 */ 


socket.on('data',function(data) { 


/* 打 Eh data*/ 
console.log(data.toString()); 
Fs 


/* 设 置 监听 端口 */ 
server. listen (18001; Eunctioni) ET 
console.log ("server is listening');/ 


i: 
运行 这 段 代 码 之 后 ， 通 过 Telnet 等 工具 连接 后 ， 发 送 一 段 数 据 给 服务 端 ， 在 命令 行 中 就 
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可 以 发 现 数据 已 经 被 打印 出 来 了 ， 如 图 6.5 所 示 。 


Node.js command prompt - node 6-7,s 


erver is listening 
sillo TCP Server. 


is message is from client. 
king. 


65 打印 客户 端 发 送 的 数据 
socket 对 象 除 了 有 data 事件 外 ， 还 有 connect, end, error, timeout 等 事件 。 


616 发送 数据 给 客户 端 

利用 socket.writeO0 可 以 使 TCP 服务 器 发 送 数据 。 这 个 方法 只 有 一 个 必需 参数 ， 束 是 需要 
发 送 的 数据 ; 第 二 个 参数 为 编码 格式 ， 可 选 。 同 时 ， 可 以 为 这 个 方法 设置 一 个 回调 函数 。 当 有 
用 户 连 接 TCP 服务 器 的 时 候 ， 将 发 送 数据 给 客户 端 ， 代 码 如 下 : 


【示例 6-8] 
/* 引 入 net 模块 */ 
var net = require('net');/ 
/* 创 建 服务 器 */ 
var server = net.createServer (function (socket) { 
/* 获 取 地 址 信息 */ 
var address = server.address(); 
var message = "'client, the server address is " + JSON.stringify (address); 
/* 发 送 数据 */ 
socket.write (message, Eunction() { 
var writeSize = socket.bytesWritten; 
console.log (message + "has send'); 
console.log('the size of message is ' + writeSize); 
]); 
/* 监 听 data 事件 */ 


socket .on("'data",function(data) l 
console.Tog(data-toString()); 


var readSize = socket.bytesRead; 
console.log('the size of data is ' + readSize); 
}); 
I); 
/* 设 置 监听 端口 */ 


server.listen(18001,function() í 
console.log("'server is listening'); 


}); 
运行 这 段 代码 并 连接 TCP 服务 器 ， 可 以 看 到 Telnet 中 收 到 了 TCP 服务 器 发 送 的 数据 ， 
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Telnet 也 可 以 发 送 数据 给 TCP 服务 器 ， 如 图 6.6 所 示 。 


Node.js command prompt - node 6-8.js 
server is listening A 
lient, the server address is ["address":"::", "family": "1Pv6 
", "port":18001}has send 


size of message is 75 
This message is from clinet. 
size of data is 28 


6.6 TCP 服务 器 发 送 的 数据 


在 上 面 这 段 代码 中 还 用 到 了 socket 对 象 的 bytesWritten 和 bytesRead 属性 ， 这 两 个 属性 分 
别 代表 着 发 送 数据 的 字 节 数 和 接收 数据 的 字 节 数 。 
除了 上 面 这 两 个 属性 外 ，socket 对 象 还 有 以 下 属性 : 


@ 。 socket.localPort: 本 地 端口 的 地 址 。 

@ socketlocalAddress: 本 地 IP 地 址 。 

@ socket.remotePort: 远程 端口 地 址 。 

@ socket.remoteFamily: 远程 IP WRK. 
@ socket.remoteAddress: 远程 的 卫 地 址 。 


以 下 这 段 代 码 可 以 将 这 些 属 性 打印 在 控制 台 。 


【示例 6-9】 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 创 建 服务 器 */ 


var server = net.createServer(function(socket) { 


/* 本 地 端口 */ 


consele  Tog('localpBortr: 1 E socket'ulocalPort); 


/* 本 地 r P 地 址 */ 

console.log('localAdress: ' + socket.localAddress); 

/* 远 程 端口 */ 

console.log("'remotePort: ' + socket.remotePort); 

/* 远 程 IP 协议 簇 */ 

console.log('remoteFamily: ' + socket.remoteFamily); 
/* 远 程 IP 地 址 */ 

console.log('remoteAddress: ' + socket.remoteAddress); 


}); 
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/* 设 置 监听 端口 */ 
SeweTmeEsEen SnORneETOnIN NET 
console.log("'server is listening'); 


}); 


运行 这 段 代码 并 连接 TCP 服务 器 ， 可 以 在 命令 行 中 看 到 如 图 6.7 所 示 的 信息 。 


Node.js command prompt - node 6-9.Js 


server is listening 
localPort: 18001 
localAdress: ::1 
emotePort: 54188 
emoteFami ly: IPvó 
emoteAddress: ::1 


6.7 socket 的 相关 属性 


构建 TCP AAi 


Node.js 在 创建 一 个 TCP 客户 问 的 时 候 同 样 使 用 的 是 net H) 模块 。 


6.2.1 使 用 Node js 创建 TCP 客户 端 


为 了 使 用 Node.js 创建 TCP 客户 端 ， 首 先 要 使 用 require('net") 来 加 载 net 模块 。 创 建 一 个 
TCP 客户 端 只 需要 创建 一 个 连接 TCP 客户 端的 socket 对 象 即 可 : 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 创 建 客户 端 */ 


var client = new net.Socket ();}; 
创建 一 个 socket 对 象 的 时 候 可 以 传 入 一 个 json 对 象 。 这 个 对 象 有 以 下 属性 : 


© íd: 指定 一 个 存在 的 文件 描述 符 ， 默 认 值 为 null。 

@ readable: 是 否 允 许 在 这 个 socket 上 读 ， 默 认 值 为 false, 

© writeable: 是 否 允 许 在 这 个 socket L5, REA false. 

@ allowHalfOpen: 该 属性 为 false 时 ，TCP 服务 器 接收 到 客户 端 发 送 的 一 个 FIN 包 后 将 
会 回 发 一 个 FIN 包 ; 该 属性 为 true 时 ，TCP 服务 器 接收 到 客户 端 发 送 的 一 个 FIN 包 
后 不 会 回 发 FIN 包 。 
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6.2.2 连接 TCP RRJ RS 


创建 了 一 个 socket 对 象 后 使 用 socket 对 象 的 connect0 方 法 就 可 以 连接 一 个 TCP 服务 器 
例如 ， 连 接 【 示 例 6-9】 中 创建 的 TCP 服务 器 ， 可 以 使 用 以 下 代码 。 


【示例 6-10】 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 创 建 客户 端 */ 


var client = net.Socket(}); 


/* 设 置 连接 的 服务 器 */ 
client- -connect (L800 r 127 05505 PEFunction()ri 


console.log ("connect the server'); 


H)? 

运行 【示例 6-9】 的 代码 启动 TCP 服务 器 后 运行 【示例 6-10】 这 段 代 码 ， 可 以 在 命令 行 中 
发 现 打 印 了 一 些 字 样 ， 说 明 connect0 方 法 的 回调 函数 已 经 执行 了 ， 即 已 经 成 功 连接 上 TCP 服 
务 器 ， 如 图 6.8 所 示 。 


Node.js command prompt - node 6-10.js 


the server 


6.8 连接 TCP 服务 器 


6.2.3 获取 从 TCP 服务 器 发 送 的 数据 


在 6.1 节 中 已 经 介绍 了 一 个 socket 对 象 有 data, error. close, end 等 事件 ， 因 此 也 可 以 通 
过 监听 data 事件 来 获取 从 TCP 服务 器 发 送 的 数据 。 
【示例 6-11] 
/* 引 入 net 模块 */ 


var net = require('net');/ 


/* 创 建 客户 端 */ 


var client = net.Socket(); 


/* 设 置 连接 的 服务 器 */ 
c temi: "connect (TgG6001T i127 0 D T" EmecEtiron(lt 
console.log("'connect the server'); 


H: 


/* 监 听 data 事件 */ 
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celient -on data FuUnctron (data) 1 
console.log ('the data of server is ' t data-toString()); 


}); 


运行 【示例 6-8】 的 代码 启动 TCP 服务 器 后 ， 运 行 上 面 这 段 代 码 ， 可 以 发 现 命 令 行 中 已 经 
输出 了 来 自 服务 端的 数据 ， 说 明 此 时 已 经 实现 了 服务 端 和 客户 端 之 间 的 通信 。 


6.2.4 [s] TCP 服务 器 发 送 数 据 


因为 TCP 客户 端 是 一 个 socket 对 象 ，6.1 节 中 提 到 的 write0 方 法 以 及 localPort、localAdress 
等 属性 依旧 可 用 ， 所 以 可 以 使 用 以 下 代码 来 铝 TCP 服务 器 发 送 数据 。 


【示例 6-12】 
/* 引 入 net 模块 */ 


var net = require('net'); 


/* 创 建 客户 端 */ 


var client = net.Socket(); 


/* 设 置 连接 的 服务 器 */ 
clremeseconneceE(le00n "2 7 Dp 50 l Eunctaon(yt 
console.log ("connect the server'); 


/* 发 送 数据 */ 
client.write ('message from client');/ 


H); 


/* 监 听 data 事件 */ 
client- oni 'data!; Functiontdatay "I 
console. .log(' the data of server is 'r' Y data-tosStrimng()); 


)) ; 


/* 监 听 end 事件 */ 
client oní("'end'; function() [ 
console.log('data end'); 


}); 
运行 【示例 6-8】 的 代码 启动 TCP 服务 占 后 ， 运 行 上 面 这 段 代 码 ， 可 以 发 现 服务 器 已 经 接 
收 到 客户 端的 数据 ， 客 户 端 也 已 经 接收 到 服务 端的 数据 ， 如 图 6.9 和 图 6.10 所 示 。 
Node.js command prompt - node 6-12,s 


:\WebstormProjects\Node jsDev\chapter06>node 6-12. js 
connect the server 


s data of server is client, the server address is {"addres 
s":"::", "family":"IPv6", "port" :18001} 


69 TCP 客户 端 
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No de.js command prompt - node 6-8.js 


erver is listening 
lient, the server address is {"address":"::", "family": "IPvó 
B e da :18001}has send 


he sire of data Ja 1 


6.10 TCP 服务 端 


28% J! 30 AAR 35% tB, n] LARE BJ TAE P 09228 E iH E , ARIRE AEX 
件 模块 中 进行 学 习 。 


# . ws. i, 
Á Á š 2221 . 
a Bo. 
7 ` ' N 
cC D... 
ww O w 


在 如 今 Web 大 行 其 道 的 时 代 ， 支 撑 无 数 网 页 运行 的 正 是 HTTP 服务 器 。Node.js 之 所 以 受 
到 大 量 Web 开发 者 的 青睐 ， 与 Node.js 有 能 力 目 己 构 建 服 务 器 是 分 不 开 的 。 


6.3.1 创建 HTTP 服务 器 


在 本 书 的 第 4 章 中 已 经 提 到 HTTP 服务 器 。 只 需要 使 用 以 下 代码 就 可 以 创建 一 个 简单 的 
HTTP 服务 器 。 


【示例 6-13】 
/* 引 入 http 模块 */ 
Welln recurre ("ir Ep" IS 


/* 创 建 HTTP 服务 器 */ 
var server = http.createServer (function(req, res) { 
/* 设 置 响应 的 头 部 */ 
res.writeHead(200, í 
'content-type': 'text/plain' 
J) 


/* 设 置 啊 应 的 数据 */ 


res.end('Hello, Node.js!'); 


/* 设 置 服务 器 端口 */ 
server.listen(3000, function() í 
console.log('listening port 3000'); 
i); 


EX BARA a UED A as rB 48 BEE IRA gë 25 W| A es RGE E 4 章 中 已 经 说 
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明了 http 模块 的 主要 应 用 ， 这 里 不 再 资 述 ， 将 重点 放 在 HTTP 服务 此 优化 上 。 

上 面 这 个 HTTP 服务 器 只 是 实现 了 将 一 行 字符 串 的 数据 发 送 给 浏览 占 。 很 明显 ， 如 果 服 务 器 
只 能 发 送 一 些 字 符 串 ， 那 几乎 是 不 可 用 的 ， 因 此 需要 对 上 面 这 个 服务 咒 的 功能 进行 拓展 。 通 过 文 
件 模块 读 取 文 件 并 发 送 给 浏览 器 就 是 一 个 不 错 的 选择 ， 将 上 面 的 代码 修改 为 以 下 代码 。 


【示例 6-14 】 
/* 引 入 http 模块 */ 
Varihtip requirel REEDIN; 


/* 引 入 fs 模块 */ 


var fs = require (('fs'); 


/* 创 建 HTTP 服务 器 */ 


var server = http.createServer (unction (eq res) 


/# 设 置 啊 应 的 头 部 #/ 


res.writeHead(200, (í 
'content-type': 'text/html' 
J); 


/* 读 取 文 件数 据 */ 


var data = fs.readFileSync('./index.html'); 


/# 啊 应 数据 #/ 
res.write (data); 
res.end(); 


)); 


/# 设 置 服务 器 端口 */ 
server listen(3000 EFüunctioní()]'i 


console- tog('Tistemirnqg port 3000") 7 
}); 


{ 


同时 在 同 级 目录 中 创建 一 个 名 为 index html 的 文件 ， 写 入 以 下 代码 : 


< I pDOCG TYPE Th Lmi:> 
<html lang="en"> 
<head> 
<meta charset- UTE 8 > 
<title>Node.js</title> 
<S j y je 
ht 


Color- red: 
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</style> 
</head> 
<body> 
<hl>Hello, Node.js</hl> 
</body> 
</html> 


运行 代码 ， 利 用 浏览 器 访问 localhost:3000 这 个 地 址 ， 如 图 6.11 所 示 。 


Node.js x |+ 


< Ea O ilo a 2 


Hello, Node.js 


>| 
611 HTTP 服务 器 发 送 的 文件 信息 


需要 提 及 的 是 ， 这 里 HTTP 服务 器 在 发 送 给 浏览 器 的 头 部 信息 中 将 content-type 修改 为 了 
text/html, content-type 的 作用 融 是 用 来 表示 客户 端 或 者 服务 右 传 输 数据 的 类 型 ， 服 务 器 和 客户 
端 通 过 这 个 值 来 做 相应 的 解析 。 如 果 将 这 个 值 修改 为 原来 的 text/plain， 浏 览 器 中 将 显示 
index.htm 文件 中 的 所 有 代码 ， 而 这 显然 不 是 我 们 所 希望 的 。 


6.3.2 HTTP 服务 器 的 路 由 控制 


上 一 节 中 的 服务 器 虽然 已 经 可 以 通过 读 取 文件 数据 来 发 送 给 客户 端 了 ,但 是 并 没有 做 任何 
的 路 由 控制 , 在 浏览 器 中 输入 任何 URL 都 将 返回 同样 的 内 容 。 简 单 来 说 ， 路 由 就 是 URL 到 也 
数 的 映射 。 

要 做 到 路 由 控制 ， 通 过 前 面 的 学 习 可 以 预想 到 ， 需 要 设 定 的 必然 有 content-type。 这 里 假 
定 只 需要 处 理 html、js、css 和 图 片 文件 ， 创 建 一 个 名 为 mime.js 的 文件 ， 写 入 以 下 代码 : 


module -exports = { 


ET 全 


oss text/cssu 
SEE avascript"; 
i E: sas ash Te SP Re 8 Š EP 
"ico "image/x-icon", 
"jpeg": "image/jpeg", 


-jpg": "image/jpeg", 
" 人 : "image/png" 


需要 做 到 路 由 控制 ， 也 就 需要 知道 用 户 请 求 的 URL 地 址 ， 也 就 是 req.url， 所 以 通过 这 个 
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属性 获取 到 URL 后 也 就 可 以 对 路 由 进行 控制 了 ， 如 以 下 代码 所 示 。 
【示例 6-15] 
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/# 设 置 服务 器 端口 */ 

server.listen(3000, function() í 
comnsoile l tog("'listening' port 30007); 

Ey 


这 里 通过 req.url 对 路 径 处 理 判 断 来 返回 不 同 的 资源 ， 从 而 做 到 简单 的 路 由 控制 。 


利用 UDP 协议 传输 数据 与 发 送 消息 


前 文中 所 提 到 的 TCP 数据 传输 协议 是 一 种 可 靠 的 数据 传输 方式 ， 在 数据 传输 之 前 必须 建 
立 客户 端 与 服务 端 之 间 的 连接 。 而 UDP 数据 传输 是 一 种 面 同 非 连接 的 协议 ， 所 以 其 传输 速度 
比 TCP 更 快 。 不过， 也 正 因 为 UDP 数据 传输 提高 了 传输 的 速度 ， 所 以 可 靠 性 不 如 TCP 数据 
传输 方式 。 


64.1 创建 UDP 服务 器 


为 了 使 用 Node.js 创建 UDP 服务 器 ， 首 先 要 使 用 require(dgram) 加 载 dgram 模块 。 然 后 使 
用 dgram 模块 中 的 createSocket0 方 法 创建 一 个 UDP 服务 器 。 这 个 方法 接收 一 个 必需 参数 和 一 
个 可 选 参数 ， 必 有 需 参数 是 一 个 表示 UDP 协议 的 类 型 ， 可 指定 为 “udp4” 或 者 “udp6”， 具 体 
如 下 : 
/* 引 入 dagram 模块 */ 


Var dgram = require ("dgram'); 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4'); 
这 个 方法 中 的 可 选 参数 为 一 个 回调 函数 ， 是 UDP 服务 器 接收 数据 时 触发 的 回调 函数 ， 可 
以 接收 两 个 参数 ， 一 个 为 接收 到 的 数据 ， 男 一 个 为 存放 发 送 者 信息 的 对 象 ， 具 体 如 下 : 
/* 引 入 dgram 模块 */ 


Im 人 人 ae 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4', function (msg, rinfo) { 
// your code 


He 
rinfo 对 象 的 属性 及 属性 值 如 下 : 


@ address: 表示 发 送 者 地 址 。 
© family: 表示 发 送 者 使 用 的 地 址 为 “ipv4” 或 者 “ipv6”。 
@ port: 表示 发 送 者 的 端口 号 。 
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© size: 表示 发 送 者 发 送 数 据 的 字 节 数 。 

创建 完 一 个 socket 疹 口 对 象 后 还 需要 绑 定 一 个 端口 号 才能 创建 UDP 服务 器 ， 可 利用 
socketbind() 方 法 绑 定 一 个 端口 号 。 这 个 方法 接收 一 个 必需 参数 、 两 个 可 选 参数 。 必 需 参 数 为 
需要 绑 定 的 端口 号 ， 两 个 可 选 参 数 为 地 址 和 回调 函数 ， 具 体 如 下 : 
/* 引 入 dgram 模块 */ 


var dgram = requirel('dgram'); 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4', function (msg, rinfo) { 
// your code 


}); 


/* 绑 定 端口 */ 
Socket bind(412347 "Tocalhost Functlion () 'Í 
console:Tog("'bind' 412341); 
J); 


这 是 一 个 简单 的 UDP 服务 器 , 与 net 和 http 方法 类 似 ， 因 为 createSocket 方法 返回 的 是 一 
个 socket 对 象 。 一 个 socket 对 象 主 要 有 以 下 事件 : 


© message: 接收 数据 时 触发 。 

© listening: 开始 监听 数据 报 文 时 触发 。 

@ close: 关闭 socket 时 触发 。 

@ error: 发 生 错 误 时 触发 。 

显然 上 文中 使 用 createSocket(0 方 法 中 的 回调 函数 就 是 监听 message 事件 ,因此 使 用 createSocket() 
方法 时 可 以 不 指定 回调 函数 ， 直 接 显 式 监 听 message 事件 同样 可 以 达到 相应 的 效果 : 
/* 引 入 dgram 模块 */ 


vac dgramni— Eequlrel darame ys 


/* 创 建 UDP 服务 器 */ 


var socket = dgram.createSocket ('udp4"'); 


/* 绑 定 端口 */ 

seocker pind(4123242 Er Tocalhnost "ç Eumct ion i (iri 
console: log beind 412345); 

)); 


/* 监 听 message 事件 */ 
socket.on ( "message"/ function (msg, rinfo) { 
console. rog (msg `LoStrimng()); 


H: 
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将 事件 综合 使 用 则 代码 如 下 。 
/* 引 入 dgram 模块 */ 


var dgram = require ('dgram"); 


/* 创 建 UDP 服务 器 */ 


var socket = dgram.createSocket ('udp4'); 


/* 绑 定 端口 */ 

söCket bind (412347 F rocalhoste!; FEimcETon f () Ú ] 
console. logi "bind 412341); 

)); 


/* 监 听 message 事件 */ 
SOCket -on ( "message"y/ function (msg, rinfo) { 
Console”"rog(msqgq'LtoString()); 


}); 


/* 监 听 listening 事件 */ 
Socket- -oni Listening rr Function) el 
console.log('listening begin'); 


}); 


/* 监 听 close 事件 */ 
socket on ("close r EumctTom() i 
console.log("'server closed'); 


)); 


/* 监 听 error 事件 */ 
socket on ("'error", function (err) í 


console.log(err); 


}); 
一 个 socket 对 象 主 要 有 以 下 方法 : 
bind): 绑 定 端口 号 。 
send): 发 送 数 据 。 
address(): 获取 该 socket 端口 对 象 相关 的 地 址 信息 。 
close): 关闭 socket 对 象 。 
bind(0 方 法 在 上 文中 已 经 介绍 过 ，send(0) 方 法 用 来 发 送 数据 ， 其 完整 的 参数 使 用 如 下 : 


socket.send(buf, offset, length, port, address[,callback]) 


© buf 代表 需 要 发 送 的 消息 ， 可 以 是 缓存 对 象 或 者 字符 串 。 
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offset 是 一 个 整数 数字 ， 代 表 消 息 在 缓存 中 的 偏 移 量 。 

length 是 一 个 整数 数字 ， 代 表 消 息 的 比特 数 。 

port 代表 发 送 数据 的 端口 号 。 

address 代表 接收 数据 的 socket 端口 对 象 的 地 址 。 

callback 为 数据 发 送 完毕 所 需 调 用 的 回调 函数 。 这 个 回调 函数 的 第 一 个 参数 是 error 
对 象 ， 第 二 个 参数 为 数据 发 送 的 比特 数 。 


因此 使 用 这 个 方法 看 起 来 会 像 是 这 样 的 : 
/* 引 入 dgram 模块 */ 


var dgram = require ('dgram'); 


/* 创 建 puffer*/ 


var message = new Buffer.from('some message '); 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4', function (msg, rinfo) { 


console.Tloq(msg.toString());/ 


/* 发 送 数据 */ 
socket.send (message, 0, message.length, rinfo.port, rinfo.address, function (err, 
bytes) ( 
If (err) mi 
console.log (error); 
TECUCN; 


| 


console.log("send " + bytes + ' message'); 
}) 
}); 


/* 绑 定 端口 */ 

sSsocker bind (41234 localhost. m Function () 4 
console- Log ("bind 41234"); 

)); 


64.2 创建 UDP 客户 端 


因为 UDP % 30 K Ji F. tB Ze — ` socket 端口 对 象 ， 所 以 同样 可 以 通过 创建 一 个 socket 对 
象 来 构建 UDP 客户 端 ， 这 样 得 到 的 是 一 个 socket 对 象 ， 所 以 同样 可 以 使 用 上 述 介 绍 的 相关 方 
法 。 如 下 代码 就 可 以 实现 一 个 简单 的 UDP 客户 端 。 

/* 引 入 dgram 模块 */ 


var dgram = require ('dgram'); 
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/* 创 建 bpuffer*/ 
var message = new Buffer.from('some message from client');/ 
/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4'); 
/* 发 送 数据 */ 


SOCket .Send (message, 0, message.length, 41234, 'localhost', function (err, bytes) 
{ 
Jf [err) Fi 
console.log(err); 
下 已 
} 
console.log('client send ' + bytes + " message ' ) ; 


}); 


/* 监 听 message 事件 */ 
socket.on('message', function (msg, rinfo) { 


console.log("some message form server"); 


}); 


因此 通过 创建 一 个 socket 对 象 作 为 客户 端 和 一 个 socket 对 象 作 为 服务 端 就 可 以 实现 UDP 
协议 的 通信 。 


【示例 6-16 】 
/* 引 入 dgram 模块 */ 
var dgram = require ('dgram') ; 
/* 创 建 bpuffer*/ 


var message = new Buffer.from('some message from server'); 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4', function (msg, rinfo) { 
Ccorisote"Fosg(msgq'toStErime() i; 
/* 发 送 数据 */ 
socket.send (message, 0, message .length, rinfo.port, rinfo.address, function (err, 
bytes) ( 
if(err) { 
console.log(error); 
TECEN, 
} 
console.log ("send " + bytes + ' message');/ 
}) 
}); 
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/* 绑 定 端口 */ 

socket bind (41234 "localhost !; function () i 
console log (bind 412341); 

|); 


【示例 6-17] 
/* 引 入 dgram 模块 */ 


var dgram = require ('dgram'); 


/* 创 建 puffer*/ 


var message = new Buffer.from('some message from client'); 


/* 创 建 UDP 服务 器 */ 
var socket = dgram.createSocket ('udp4'); 
/* 发 送 数据 */ 


socket .send (message, 0, message.length, 41234, 'localhost', function (err, bytes) 
{ 
JE [err)"R1 
console. Togí(err); 
下 已 ES 
} 
console.log('client send ' + bytes + ' message'); 


}); 


/* 监 听 message 事件 */ 
socket.on('message', function (msg, rinfo) { 
console.log("some message form server"); 


J); 


运行 【示例 6-16】 和 【示例 6-17】 的 代码 ， 依 次 启动 UDP 服务 器 和 UDP 客户 端 ， 可 以 
发 现 已 经 实现 了 UDP 服务 器 和 UDP 客户 端的 通信 ， 如 图 6.12 和 图 6.13 所 示 。 


ni 24 Wanqa 


6.12 UDP 服务 器 


Node.js command prompt - node 6-17js 
lient send 24 message 


some message form server 


图 6.13 UDP 客户 端 
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O.D 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 

1. 如 何 通过 net 模块 创建 一 个 TCP 服务 器 ? 

2. 如 何 创建 一 个 HTTP 服务 器 和 HTTP 客户 端 ? 
3. HTTP 路 由 控制 的 思想 是 什么 ? 

4. UDP 中 socket 对 象 有 哪些 常用 的 方法 ? 


T13 
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数据 库 在 互联 网 中 的 重要 性 不 言 而 喻 。 数据 库存 放 着 大 量 的 信息 ， 是 很 多 互联 网 公司 的 命 
脉 。 目 前 运用 广泛 的 有 关系 型 数据 库 和 非 关 系 型 数据 库 。MySQL 数据 库 是 关系 型 数据 库 的 杰 
出 代表 ，MongoDB 则 是 近 几 年 大 热 的 非 关 系 型 数据 库 。 本 章 将 主要 介绍 Node.js 与 这 两 种 数 
据 库 的 连接 和 交互 操作 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 连接 MySQL 数据 库 并 进行 操作 。 

@ 连接 MongoDB 数据 库 并 进行 操作 。 

© 了 解数 据 库 基础 知识 。 


使 用 mongoose 连接 MongoDB 


MongoDB 是 一 个 基于 分 布 式 文件 存储 的 数据 库 ， 由 C++ 语言 编写 ,目的 是 让 Web 应 用 提 
供 可 拓展 的 高 性 能 数据 存储 解决 方案 。 


7.1.1 MongoDB 介绍 


目前 ，MongoDB 是 非 关 系 型 数据 库 中 功能 最 丰 定 、 最 像 天 系 型 数据 库 的 产品 。MongoDB 
是 由 10gen 团队 于 2007 年 开发 的 ， 并 于 2009 年 2 月 首 度 推出 的 。MongoDB 支持 的 数据 结构 
类 似 于 json 的 bson 格式 。 这 种 数据 结构 非常 松散 ， 可 以 很 方便 地 存储 比较 复杂 的 数据 类 型 。 
MongoDB 的 主要 特点 是 高 性 能 、 易 存储 、 易 使 用 、 易 部 署 。 

MongoDB 的 最 小 数据 单位 是 文档 〈 类 似 于 关系 型 数据 库 中 的 行 ) 。 文 档 是 由 多 个 键 及 其 
对 应 的 值 组 成 的 《类似 于 json) ， 一 组 文档 共同 组 成 了 一 个 集合 。 集 合 类 似 于 关系 型 数据 库 中 
的 表 ， 但 是 一 个 集合 中 的 文档 可 以 是 各 式 各 样 的 ， 一 组 集合 就 组 成 了 一 个 数据 库 。MongoDB 
可 以 承载 多 个 数据 库 ， 这 些 数 据 库 可 以 看 作 是 相互 独立 的 。 

(1) MongoDB 的 官方 网 站 是 https://www.mongodb.com/。 读 者 可 以 在 MongoDB 官方 网 
站 的 下 载 页 面 https://www.mongodb.com/download-center 选择 相应 的 版 本 进行 下 载 ， 如 图 7.1 
所 示 。 
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Current Release | Previous Releases | Development Releases 
Current Stable Release (3.4.1) 
12/20/2016: Release Notes | Windows inux é O5X Solaris 
Sisic a °p 
Download Source: tgz | zip 
Versi 


Windows Server 2008 R2 64-bit and later, with SSL support x64 


Installation Package: 


Binary: Irstallation Instructions | All Version Binaries 


7.1 MongoDB 下 载 页 面 
(2) 在 这 里 以 Windows 版 本 为 例 ， 将 下 载 下 来 的 MongoDB 软件 按照 常规 软件 的 步 又 安 
装 即 可 。 需 要 注意 的 是 ， 在 安装 过 程 中 ，MongoDB 默认 安装 在 C 盘 ， 可 以 在 安装 过 程 中 选择 
安装 的 路 径 〈 因 为 MongoDB 的 操作 需要 用 到 这 个 路 径 ， 所 以 读者 要 选择 一 个 合适 的 路 径 进行 
安装 ) ， 如 图 7.2 和 图 7.3 所 示 。 


Choose Setup TYpe Custom Setup 
Choose the setup type that best suits your needs Select the way you want features to be installed. 


Click the icons in the tree below to change the way features will be installed. 


All program features will be installed. Requires he most disk space. = MongoDB 3.4.1 2008R2Flus 55 
mam D-E E 08R2Flu Sagan e ssamarisn sb 15 
users to chcose which program features wil be instaled and where This feature requires 1549KB on 
Recommended for advanced users. your hard drive. It has 5 of 6 
es selected. The 


Allows 
they will be installed. 


图 7.2 MongoDB 选择 Custom 7.3 MongoDB 选择 Browse 自 定 义 路 径 


(3) 安装 完成 后 ， 需 要 配置 数据 存储 的 文件 来 和 MongoDB 的 日 志文 件 夹 。 在 MongoDB 
安装 的 路 径 中 新 建 一 个 名 为 db 的 文件 夹 作为 数据 库存 储 的 文件 来 ， 同 时 新 建 一 个 名 为 
mongolog 的 文件 夹 作 为 日 志文 件 存储 的 文件 夹 ， 在 db 文件 夹 的 同 级 目录 下 新 建 一 个 名 为 
mongo.config 的 文件 作为 配置 文件 ， 写 入 以 下 内 容 : 
## 数 据 文件 
dbpath= ## 你 的 数据 存储 文件 夹 地 址 
## 日 志文 件 
logpath= ## 你 的 日 志文 件 地 址 


此 时 ， 整 个 目录 结构 如 图 7.4 所 示 。 
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[] db zit 
| | MongoDB 文件 去 
|_| mongolog 文件 去 
E mongo.config CONFIG 文件 


7.4 MongoDB 配置 目录 
(4) 打开 CMD 工具 ， 输 入 以 下 命令 ， 就 可 以 局 动 MongoDB (í: 
mongod --dbpath 你 的 db 文件 夹 地 址 


这 里 仅仅 是 对 MongoDB 进行 简单 的 介绍 , 更 多 知识 读者 可 以 通过 阅读 相关 的 书籍 进行 学 
JIŽ. 


7.1.2 ”使 用 mongoose 连接 MongoDB 


mongoose 是 一 个 基于 node-mongodb-native 开发 的 MongoDB 的 Node.js 驱动 ， 可 以 很 方 
便 地 在 异步 环境 中 使 用 。 

mongoose 的 GitHub 地 址 是 https://github.com/Automattic/mongoose。mongoose 的 官方 网 站 
是 http://mongoosejs.com/， 读 者 可 以 在 mongoose 的 官方 网 站 中 阅读 相应 的 说 明和 官方 文档 。 

使 用 mongoose 模块 前 首先 需要 通过 NPM 安装 这 个 模块 : 


npm install mongoose 


mongoose 模块 通过 connect0 方 法 与 MongoDB 创建 连接 。connect0 方 法 中 需要 传递 一 个 
URI 地址 ， 用 来 说 明 需 要 连接 的 MongoDB 数据 库 。 与 本 地 的 MongoDB 数据 库 article 建立 连 


接 的 代码 如 下 。 
【示例 7-1] 
/* 引 入 mongoose 模块 */ 
const mongoose = require('mongoose'); 
/* 定 义 mongodb 地 址 */ 
const uri = 'mongodb://localhost/article'; 
/* 连 接 mongodb*/ 


mongoose connect (uri, function(err) [ 
ls (er ini 
console.log('connect failed'); 
console.log(err); 
ESETEM; 
} 
console.log ("connect success'); 


)); 
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【代码 说 明 】 
connect) D ŻEE MongoDB 连接 ， 回 调 函 数 中 er 为 参数 ， 夺 出现 连接 错误 ， 则 打印 出 
“connect failed”; 硅 连 接 成 功 ， 则 打印 出 “connect success”。 
运行 这 段 代 码 ， 如 果 MongoDB 服务 已 经 正 第 开局 ， 束 会 在 控制 台 打 印 出 “connect 
success ”字样 ， 如 图 7.5 所 示 。 


Node.js command prompt - node 7-1,s = E x 


(node:8664) DeprecationWarning: current URL string parser is deprecated, ^ 
and will be removed in a future version. To use the new parser, pass op 


ion { useNewUr1Parser: true } to MongoClient. connect. 
onnect success 


75 ”使 用 connect0 方 法 创建 MongoDB 连接 
需要 说 明 的 是 ，connect0 方 法 中 uri 参数 的 完整 示例 如 下 : 
mongodb://user:pass@localhost:port/database 


@ user 代表 MongoDB 的 用 户 名 。 
© pass 代表 用 户 名 对 应 的 密码 。 
© port 代表 MongoDB 服务 的 端口 号 。 


7.1.3 使 用 mongoose 操作 MongoDB 


mongoose 中 的 一 切 由 schema 开始 。schema 是 一 种 以 文件 形式 存储 的 数据 库 模 型 骨架 ， 
并 不 具备 数据 库 的 操作 能 力 。schema 中 定义 了 model 中 的 所 有 属性 ， 而 model 则 对 应 一 个 
MongoDB 中 的 collection。 以 下 代码 定义 了 一 个 schema 并 且 注 册 成 了 一 个 model。 


【示例 7-2】 
/* 引 入 mongoose 模块 */ 
const mongoose = require('mongoose'); 
/* 定 义 mongodb 地 址 */ 
const uri = 'mongodb://localhost/article'; 
/* 连 接 mongodb*/ 


mongoose .Connect (uri, function (err) (Í 
if(err) í 
console.log('connect failed'); 
console.lgo (err); 
ESEurny 
} 
console.log("connect success'); 


J); 
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/* 定 义 Schema*/ 
const ArticleSchema = new mongoose -Schema ({ 
Elier Strirey 
authors PSU r ir; 
content: String; 
publishTime: Date 
1); 


mongoose.mode1 ( 'Article",ArticleSchema); 


【代码 说 明 】 

这 段 代 码 通 过 实例 化 一 个 mongoose.Schema0 对 象 定义 一 个 model 的 所 有 属性 ， 类 似 于 关 
系 型 数据 库 中 的 字段 和 字段 的 数据 类 型 schema 合法 的 类 型 有 String, Number Date, Buffer, 
Boolean, Mixed, Objectid 和 Array. mongoose 中 通过 mongoose.model() 方 法 注册 一 个 model. 

在 mongoose 中 可 以 使 用 save 方法 将 一 个 新 的 文档 插入 collection 中 。 


【示例 7-3】 
/* 引 入 mongoose 模块 */ 


const mongoose = require ('mongoose'); 


/* X mongodb 地 址 */ 


const uri = 'mongodb://localhost/article'; 


/* 连 接 mongodb*/ 
mongoose.connect (uri, function (err) { 
LELETEI I 
console.log ('connect failed'); 
console.lgo (err); 
CSCA; 
] 
console.1log ("connect success'); 


)) ; 


/* 定 义 Schema*/ 
const ArticleSchema = new mongoose.Schema ({ 
LirlelspString; 
sb yo s E SETTING 
content: String; 
publishTime: Date 
)); 


mongoose.model ( 'Article',ArticleSchema); 


const Article = mongoose.model ('Article'); 


var art = new Article ([ 
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Citlesmrnode js 
author: nodet; 
content: 'node.js is great!', 


publishTime: new Date () 


/* 将 文档 插入 集合 中 */ 
art -save (function(err) |I 
Tf(err) I 
console.log('save filed'); 
console.log(err); 
}else{ 


console.log ('save successed'); 


【代码 说 明 】 
这 段 代 码 调用 名 为 Article 的 model， 之 后 定义 了 一 个 Article 的 文档 ， 最 后 使 用 save 将 记 
录 插 入 相应 的 collection 中 。save0 方 法 中 的 回调 函数 监听 是 否 出 错 。 
运行 这 段 代 码 ， 在 MongoDB 运行 正常 的 情况 下 ， 控 制 台 将 输出 “save successed” 字 样 。 
可 以 在 控制 台 对 MongoDB 进行 操作 来 查看 MongoDB 中 是 人 否 存在 这 样 一 条 记录 ， 连 接 完 
MongoDB 后 打开 控制 台 ， 输 入 以 下 命令 切换 至 article 数据 库 : 


use article 


切换 成 article 数据 库 后 可 以 使 用 以 下 命令 查看 article 数据 库存 在 的 所 有 collection: 


show collections 


这 时 ， 可 以 看 到 控制 台中 存在 一 个 名 为 articles 的 collection， 如 图 7.6 所 示 。 


Nodejs command prompt - mongo 


F show collections 


rticles 


图 7.6 查看 数据 库 中 的 collection 
通过 以 下 命令 查看 这 个 名 为 articles 的 collection 中 的 所 有 文档 : 


dbeartiecles Frnd() 


如 果 刚 才 的 文档 插入 成 功 ， 控 制 台 就 会 显示 这 个 文档 ， 如 图 7.7 所 示 。 
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> db. articles. find) 
: Objectld("5b90efb256f3602f60465ed7"), “i 
n. "node", "content" : “node. n is great!", "publ ishT ime" 
Date ("2018-09-06T09 : 13:22. 4242"), : 81 


图 7.7 文档 插入 成 功 


名 为 articles 的 collection 中 出 现 了 插入 的 文档 , 说明 MongoDB 中 的 确保 存 了 刚刚 插入 的 
这 条 记录 。 

当然 ， 使 用 mongoose 同样 可 以 查询 相应 的 数据 。 如 下 代码 的 功能 就 是 将 articles 这 个 
collection 中 的 所 有 文档 查询 出 来 。 


【示例 7-4】 
/* 引 入 mongoose 模块 */ 
const mongoose = require('mongoose'); 
/* 定 义 mongodb 地 址 */ 
const uri = *Tmongodb:/716calbost/artychie*v; 
/* 连 接 mongodb*/ 


mongoose.connect (uri, function (err) { 
LENerCcri | 
console.log ('connect failed'); 
console.lgo (err); 
Tn 
t 
console.log ("connect success'); 


)) ; 


/*% V. Schema* / 
const ArticleSchema = new mongoose -Schema (( 
Font le String; 
author: SErLurnde 
content SPSLErimng; 
publishTime: Date 
}); 


mongoose.model ('Article',ArticleSchema); 
const Article = mongoose.model ('Article'); 
/* 查 询 mongodb* / 


Article- findi}; Function(ere docs) f 


if(err} f 
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console. logi error); 
returni, 


} 


console- tog result: 1 T 'docs); 


J); 


【代码 说 明 】 

这 段 代 码 通过 find0 方 法 查找 相应 的 数据 记录 。find0 方 法 中 的 第 一 个 参数 是 一 个 json 对 
象 ， 定 义 查找 的 条 件 ， 第 二 个 参数 为 回调 函数 。 回 调 函 数 中 的 第 一 个 参数 是 error， 第 二 个 参 
数 是 查询 的 结果 。 

运行 这 段 代码 ， 可 以 发 现 控 制 台 输出 了 相应 的 数据 记录 ， 如 图 7.8 所 示 。 


Node.js command prompt - node 7-4,s 


7.8 mongoose 查询 记录 


在 find0 方 法 的 第 一 个 参数 中 可 以 传 入 第 选 条 件 ， 以 便 更 加 精确 地 查找 需要 查找 的 数据 。 
现 将 find0 方 法 的 代码 修改 如 下 。 


【示例 7-5】 
Article Fingd(ititle node jsr"]; Fumnction(err; docs) I 
T f (err)"t 
console- log("error*); 
Ten 


} 


console- Lioqgq( result: qdocs)s 


}); 

运行 这 段 代码 同样 可 以 查询 出 记录 。 

与 find 方法 类 似 的 还 有 findOne0 方 法 ，find0 方 法 是 查询 完 所 有 符合 要 求 的 数据 后 返回 ， 
而 findOne0 方 法 则 是 查询 一 条 数据 ， 返 回 的 是 查询 得 到 的 第 一 条 数据 。 

在 mongoose 中 可 以 直接 在 查询 记录 后 修改 记录 的 值 ， 修 改 后 直接 调用 保存 即 可 。 如 下 代 
码 香 询 数据 后 直接 修改 数据 的 title 值 为 Javascript: 

【示例 7-6] 

/* 引 入 mongoose 模块 */ 


const mongoose = require ('mongoose ' ) ; 


/* 定 义 mongodb 地 址 */ 
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同样 ， 在 命令 行 中 查询 记录 MongoDB， 可 以 发 现 原来 这 个 文档 中 的 title 值 已 经 被 修改 ， 
如 图 7.9 所 示 。 


BIN Node.js command prompt - node 7-6js 


图 7.9 mongoose 修改 数据 
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类 似 于 修改 数据 ， 删 除 MongoDB 的 文档 也 可 以 在 查询 出 文档 后 直接 调用 remove 方法 。 
如 下 代码 可 以 删除 articles 集合 中 的 所 有 文档 。 


【示例 7-7] 
/* 引 入 mongoose 模块 */ 


const mongoose = require ("mongoose ); 


/* 定 义 mongodb 地 址 */ 


const uri = "mongodb://localhost/article's 


/* 连 接 mongodb*/ 
mongoose.connect (uri, function(err) { 
if (err) { 
console.lgo (err); 
} 
J); 


/*% X. Schema* / 
const ArticleSchema = new mongoose-Schema ({ 
Lil lle 
El elaresqe = C Siersshinte s 
content: SErCing, 
publishTime: Date 
}); 


mongoose.model ( 'Article',ArticleSchema); 
const Article = mongoose.mode1 ('Article'); 


/* 查 询 mongodb* / 
Artichie ` rFfind( (1; Ffüinction(err; docs) ií 
Jf (err) i 
consolei log errori); 
1 
} 
T f (docs) í 
/* 删 除数 据 */ 
docs.forEach (function(ele) { 
ele.remove () ; 


只 有 单个 文档 可 以 使 用 remove0 方 法 ， 因 为 find0 方 法 返回 的 是 一 个 符合 查询 条 件 的 所 有 


文档 组 成 的 数组 ， 所 以 这 里 调用 数组 的 forEach0 方 法 逐个 删除 所 有 的 文档 。 同样 ,在 命令 
行 中 查询 记录 MongoDB， 可 以 发 现 原来 articles 这 个 集合 的 所 有 文档 已 经 为 空 了 。 


以 上 知识 实现 了 使 用 mongoose 对 MongoDB 数据 库 进行 简单 的 增删 查 改 。 更 多 关于 
mongoose 的 使 用 ， 读 者 可 以 通过 阅读 mongoose 的 官方 文档 进行 学 习 与 掌握 。 
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7.1 节 提 到 mongoose 模块 是 基于 node-mongodb-native 开发 的 MongoDB 的 Node.js 驱动 ， 
同样 使 用 node-mongodb-native 这 个 原生 MongoDB 驱动 也 可 以 对 MongoDB 进行 相应 的 操作 。 
node-mongodb-native 模块 的 GitHub 地 址 是 https://github.com/mongodb/node-mongodb-native， 
官方 网 站 为 http://mongodb.github.io/node-mongodb-native/， 读 者 可 以 在 官方 网 站 查看 相应 的 说 
明和 文档 进行 学 习 。 


7.2.1 使 用 node-mongodb-native 连接 MongoDB 
使 用 node-mongodb-native 模块 前 需要 通过 NPM 安装 这 个 模块 : 
npm install mongodb 


node-mongodb-native 通过 connect() 方 法 传递 一 个 URI 地 址 ， 用 来 说 明 需 要 连接 的 
MongoDB 数据 库 。 如 下 代码 即 和 本 地 的 MongoDB 数据 库 student 建立 了 连接 。 


【示例 7-8】 
/* 引 入 模块 */ 


var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 
var url = 'mongodb://localhost:21017/student"; 


/* 连 接 mongodb*/ 
MongoC lent connect (url; functaon(errr db) l 
TF Use 
console.log ('connect failed'); 
console.log (err); 
EeEurn 


} 


console.log('connect success!'); 


}) 
【代码 说 明 】 
因为 mongoose 是 基于 node-mongodb-native 开发 的 ， 所 以 两 者 的 API 有 相似 的 地 方 。 运 
行 以 上 这 段 代 码 ， 如 果 MongoDB 运行 正常 ， 将 会 打印 出 “connect success” FFE- 


7.2.2 ”使 用 node-mongodb-native 操作 MongoDB 


使 用 node-mongodb-native 驱动 需要 注意 的 是 ， 每 次 操作 完 MongoDB 都 应 该 调用 close J; 
法 来 关闭 MongoDB， 人 否则 会 影响 其 他 代码 对 MongoDB 的 操作 。 利 用 insertOne 方法 可 以 插入 
一 条 数据 ， 如 前 面 提 到 的 一 样 ，node-mongodb-native 插入 的 数据 依旧 是 json 格式 ， 有 具体 代码 
如 下 : 
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【示例 7-9] 
/* 引 入 模块 */ 


var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 
var url = 'mongodb://localhost:27017/student"; 


/* 定 义 数 据 */ 

var studentInfo = 1{ 
ola Sas TOT 7 
name: 'king', 
age: 18 

I; 


/* 连 接 mongodb*/ 
MonaoCLient "connect (uri; functaon (err; db) f 
i | 
console: Log('connect tailed)? 
console: loglerri? 
Te arm; 


) 


console.log("'connect success! '); 


war dbo = db -db student]; 
dbo.createCollection('studentCol', function (err, res) (í 
1if (err) throw err: 


console.1log(" 创 建 集合 !") ; 
dbo.collection ("studentCol").insertOne (studentInfo, function(err, res) { 


if (err) throw err; 
console.log ("文档 插入 成 功 "); 
dbp- close: 


FI? 
cb close); 


1); 
)); 


【代码 说 明 】 

这 段 代 码 将 一 个 名 为 jack 的 学 生 数 据 插入 student 数据 库 下 的 student 集合 中 , 整个 过 程 是 
打开 数据 库 一 打开 集合 一 插入 数据 一 关闭 数据 库 。 这 里 需要 说 明 的 是 ,无 论 数据 是 否 插入 成 功 ， 
在 打开 MongoDB 之 后 都 应 该 关闭 ， 否 则 将 影响 其 他 代码 对 MongoDB 数据 库 的 操作 。 

运行 这 段 代 码 , 通过 命令 行 工 具 可 以 查询 出 student 数据 库 中 的 student 集合 已 经 存在 这 样 
一 条 记录 ， 如 图 7.10 所 示 。 
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Node.js command prompt - mongo 


图 7.10 通过 命令 查看 数据 
利用 node-mongodb-native 提供 的 findOne 方法 也 可 以 将 该 数据 查询 出 来 ， 代 码 如 下 。 


【示例 7-10】 
/* 引 入 模块 */ 


var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 
var uri = 'möngodb://localhost:27017/student"; 


/* 连 接 mongodb*/ 
MongoGLlienE -connect (gr ll stunctaon (err dD) 
TF (er) [ 
console.log("'connect failed'); 
console.log(err); 
TERE; 


} 


console.log ('connect success!'); 


var dbo = db.db ("student"); 
dbo-collection( "studenECol") Findone (IT];7 Function (err; result) { 


// 返回 集合 中 所 有 数据 
1E (err) throw err? 
console.log (result); 
db- -close(); 
)); 


【代码 说 明 】 
整个 过 程 是 按照 打开 数据 库 一 打开 集合 一 查询 数据 一 关闭 数据 库 这 个 流程 严格 执行 的 。 整 
段 代 码 依旧 严格 遵循 打开 MongoDB 数据 库 后 必须 关闭 的 原则 。 
运行 这 段 代码 ， 在 MongoDB 数据 库 正常 运行 的 情况 下 ， 将 会 打印 出 这 条 数据 ， 如 图 7.11 


所 示 。 


7.11 利用 find0 方 法 查询 数据 
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node-mongodb-native 模块 支持 一 次 插入 多 条 数据 和 查询 多 条 数据 ,只 需要 使 用 insertMany( 
和 find0 方 法 即 可 。 其 中 ， 在 insertMany 中 插入 多 条 数据 时 ， 只 要 将 这 些 数据 组 成 一 个 数组 传 
递 给 insertMany 方法 即 可 。 如 下 代码 就 一 次 性 插入 了 3 条 文档 记录 。 


【示例 7-11] 
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【代码 说 明 】 
运行 这 段 代 码 ， 在 MongoDB 正常 运行 的 情况 下 ， 可 以 发 现 控制 台 打 印 出 “插入 多 条 文档 
成 功 , 共计 :3 项 .” 的 字样 ， 如 图 7.12 所 示 。 


Nodejs command prompt 


>C t success! 
插入 多 条 文档 成 功 ， 共 计 : 3 项 . 


712 ”利用 insertMany() 方 法 插入 多 条 数据 


利用 find0 方 法 可 以 验证 MongoDB 是 否 真 的 存在 刚刚 插入 的 数据 。 使 用 find 方法 之 后 需 
要 使 用 toArray0 方 法 将 这 些 数据 转化 为 一 个 数组 。 以 下 代码 可 以 查询 出 student 数据 库 下 
student 集合 中 所 有 的 数据 记录 。 


【示例 7-12】 
/* 引 入 模块 */ 


var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 
var url = 'mongodb://localhost:27017/student"; 


/* 连 接 mongodb*/ 
MorigoGC i rent -connect (uri; Function lerr; ab) | 
i se 05 | 
console.log('connect failed'); 
console.log(err) ; 
Tes eq Teri; 
} 


console.log("'connect success!'); 


var dbo = db.db ("student"); 
dbo.collection("studentCol") .find({}) .toArray (function (err, result) { // 返 
回 集合 中 所 有 数据 
3f (err) throw err} 
console.log (result); 
db-close():; 
11; 
}); 


【代码 说 明 】 

运行 这 段 代码 ， 在 MongoDB 正和 背 运 行 的 情况 下 ， 可 以 发 现 所 有 的 数据 都 已 经 组 织 成 一 个 
数组 ， 刚 刚 的 数据 也 在 这 个 数组 内 ， 说 明 上 面 的 插入 操作 和 碍 询 操作 都 是 成 功 的 ， 如 图 7.13 
所 示 。 
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713 ”利用 find0 方 法 查询 数据 


使 用 node-mongodb-native 模块 提供 的 deleteOne0 方 法 可 以 对 数据 进行 删除 ， 与 findOne0( 
方法 类 似 。delete0 方 法 的 第 一 个 参数 是 查询 条 件 ， 第 二 个 参数 是 一 个 处 理 错 误 和 结果 的 回调 


函数 。 如 下 代码 可 以 删除 最 初 插 入 的 第 1 条 数据 记录 。 


【示例 7-13】 
/* 引 入 模块 */ 


Var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 


var url = 'mongodb://localhost:27017/student'; 


/* 连 接 mongodb*/ 
MongoClient connect (url; function (err; db) f{ 
1 Ete el 
console.log('connect failed'); 
console.log (err); 
Ce edi Teri; 


) 


console.log('connect success!'); 


var dbo = db'db("student*=) r; 
var delopt = {"id": '1101'); // 查询 条 件 
dbo.collection ("studentCol") .deleteOne (delOpt, 
if (err) throw err; 
console.log ("文档 删除 成 功 ") ; 
db closet)s 


function (err; obg) "í 
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【代码 说 明 】 
运行 这 段 代 码 ， 在 MongoDB 正 第 运 行 的 情况 下 ， 可 以 发 现 控制 台 打 印 出 了 “文档 删除 成 


功 ” 的 字样 。 利 用 控制 台 工 具 碍 询 student 集合 下 的 所 有 文档 ， 同 样 可 以 发 现 第 1 条 数据 记录 
己 经 被 删除 ， 如 图 7.14 所 示 。 


Nodejs command sassa mongo 


nd Ü 
a Object Id U599103596914e5118c0c94e9”, 


: "king" 
gjectid( 有 910354631do5| 18c0cbdea )， 


: "tina", "age" 
` Ob ject Id ("5b91035d631dc5118c0cbdeb" 3; 
"ixi" "age" | 8. 


714 利用 deleteOne0 方 法 删除 数据 


node-mongodb-native 模块 的 updateOne() 方 法 可 以 更 改 数据 , 与 查询 方法 类 似 , updateOne0 
方法 的 第 一 个 参数 是 查询 条 件 ， 第 二 个 参数 是 更 改 后 的 数据 ， 第 三 个 参数 是 一 个 处 理 错 误 和 结 
果 的 回调 函数 。 如 下 代码 就 可 以 将 “id: 1103” 这 条 数据 的 名 字 改 为 “cici”。 


【示例 7-14] 
/* 引 入 模块 */ 


var MongoClient = require ('mongodb') .MongoClient; 


/* 定 义 mongodb 地 址 */ 
var url = 'mongodb://lLocalhost:27017/student!; 


/* 连 接 mongodb*/ 
MongqgoCLluenkt connect (url; fuanction (err; db) I 
if (err) [Í 
console.log ('connect failed'); 
console.log (err); 
PERTEN; 


} 


console.log ('connect success!'!); 


var dbo = db.db ("student"); 
var updateOpt = ("id": !1103'); // 查询 条 件 
var updateDetail = {$set: { "name" : "cici" }}; 


dbo.collection("studentCol") .updateOne (updateOpt, updateDetail, function (err, 


res) { 
3f (err) throw err? 


console.1og ("文档 更 新 成 功 "); 
db-cLlosel(); 
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【代码 说 明 】 

运行 这 段 代 码 ， 在 MongoDB 正常 运行 的 情况 下 ， 可 以 发 现 控制 台 打 印 出 了 “文档 更 新 成 
功 ” 的 字样 。 利 用 控制 台 工 具 碍 询 student 集合 下 的 所 有 文档 , 同样 可 以 发 现 “xixi1” 这 条 数据 
的 名 字 已 经 被 改 为 “cici”， 如 图 7.15 所 示 。 


EEN Node.js command ed mongo 


nd Ü) A 
d" > Object ld YSp91035631deS118e00bde0") “i k U S r U W 


: objeetid( 8b910359631do5118c0cbdea )， "jd" ; "4402", 
: obiestid( 91035df31dc5118c0cbdeb "jd" “100”, 


7.15 ”利用 updateOne() 方 法 更 新 数据 


前 面 已 经 实现 了 使 用 node-mongodb-native 对 MongoDB 数据 库 进 行 简单 的 增删 查 改 。 更 
多 关于 node-mongodb-native 的 使 用 , 读者 可 以 通过 阅读 node-mongodb-native 的 官方 文档 进行 
学 习 与 掌握 。 

这 里 需要 提出 的 是 ， 使 用 mongoose 会 相对 简单 一 点 ， 毕 竟 mongoose 是 基于 
node-mongodb-native 开发 的 。 如 果 读 者 对 其 感 兴趣 ， 可 以 学 习 一 下 node-mongodb-native， 对 
mongoose 的 使 用 是 有 很 大 帮助 的 。 另 外 ， 读 者 应 该 掌握 MongoDB 基本 的 增删 得 改 操作 ， 以 
便 在 学 习 过 程 中 验证 数据 的 操作 是 否 成 功 。 


J. iS MySQL 


MySQL 作为 一 种 典型 的 关系 型 数据 库 ， 在 互联 网 中 被 大 量 使 用 。 本 市 将 使 用 mysql 模块 
进行 MySQL 数据 库 的 连接 。 


7.3.1 MySQL 介绍 


MySQL 数据 库 由 瑞典 MySQL AB 公司 开发 ， 目 前 属于 Oracle 公司 。MySQL 采用 双 授 权 
模式 ， 分 为 商业 版 和 社区 版 。MySQL 数据 库 凭 借 其 体积 小 、 速 度 快 、 总 成 本 低 等 特点 被 广泛 
应 用 在 Web 开发 中 。 经 典 的 开源 软件 染 构 LAMP 中 的 M 便 是 指 MySQL. 

MySQL 的 官方 网 站 是 http://www.mysql.com/ 。 读 者 可 以 在 社区 版 下 载 网 址 
https://dev.mysql.com/downloads/mysql/ 中 选择 相应 系统 的 版 本 。 这 里 以 Windows 版 本 为 例 ， 安 
装 过 程 大 致 如 下 : 


(1) 将 下 载 的 MySQL 软件 按照 常规 软件 的 安装 步骤 安装 即 可 。 需 要 提醒 的 是 ， 在 安装 
过 程 中 ， 可 以 设置 MySQL 服务 的 端口 ， 默 认为 3306， 如 图 7.16 所 示 。 


131 


Node.js 10 SAX 


D 
MySQL. Installer Type and Networking 
MySQL Server 5.7.17 $ a ias 


Choose the correct server configuration type for this MySQL Server installation. This setting will 
define how much system resources are assigned to the MySQL Server instance. 


Config Type: | Development Machine v 


Connectivity 


Use the following controls to select how you would like to connect to this server. 
回 TCP/IP Port Number: 3306 — 
[V] Open Firewall port for network access 
C] Named Pipe Pipe Name: MYSQL 
C] Shared Memory Memory Name: MYSQL 


Advanced Configuration 


Select the checkbox below to get additional configuration page where you can set advanced 
options for this server instance. 


C] Show Advanced Options 


7.16 设置 MySQL 端口 
(2) 在 安装 过 程 中 可 以 设置 root 用 户 的 密码 、 添 加 用 户 ， 如 图 7.17 所 示 。 


MySQL. Installer Accounts and Roles 
MySQL Server 5.7.17 Root Account Password 


Enter the password for the root account. Please remember to store this password in a secure 
place. 


MySQL Root Password: |e] |à 


Repeat Password: | O O 
Accounts and Roles 


Password minimum length: 4 


MySQL User Accounts 


Create MySQL user accounts for your users and applications. Assign a role to the user that 


consists of a set of privileges. 


User Role 


Edit User 


Delete 


7.17 添加 MySQL 用 户 并 设置 密码 
G) 安装 完成 后 ， 可 以 在 控制 台 使 用 以 下 命令 来 局 动 MySQL: 


net start mysql5.7 
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在 这 里 mysql5.7 是 已 经 安装 的 带 有 版 本 号 的 MySQL 软件 名 。 J 


同样 ， 也 可 以 在 Windows 服务 中 找到 MySQL 服务 ， 然 后 进行 司 动 、 停 止 操作 ， 如 图 7.48 
所 示 。 


“服务 (本 地 ) 
选择 一 个 项 目 来 音 看 它 的 拱 述 。 名 称 述 < 动 关 型 。” 登录 为 
ISh Microsoft (R) 诊断 中 心 标 .， 诊断 本 地 系统 
Sh Microsoft Account Sign-i... a 动 (触发 ..， 本 地 系统 
Th Microsoft iSCSI Initiator ... = 本 地 系统 
Sh Microsoft Office ClickTo.. 管理 .. =n 本 地 系统 
Xh Microsoft Passport 为 用 .,. 8 S. 本 地 系统 
Şi Microsoft Passport Cont.. SH... JRE.. 本 地 服务 
© Microsoft Software Shad... Bn 本 地 系统 
Sh Microsoft Storage Space... Micr... PERZ 
X Microsoft Windows SMS ... 根据.. 动 (触发 .， 本 地 系统 
:© Mozilla Maintenance Ser... ba ; 本 地 系统 
iG, MySQL57 m 网 络 服务 
Sh Net.Tcp Port Sharing Ser.. 36 £ 本 地 了 服务 
Sh Netlogon HA.. 本 地 系统 
OA Network Connected Devi... k. ERRE... 本 地 服务 
Sh Network Connection Bro... 人 允许 .. a JAE. 本 地 系统 
Sh Network Connections k. sN : 本 地 系统 
3 Network Connectivity Ass... 得 供 .… JE. 本 地 系统 
Th Network List Service L. - Fš 本 地 服务 
Sh Network Location Aware.. KS... ss AARS 


图 7.18 从 Windows 服务 中 启动 MySQL 
(4) 启动 MySQL 后 ， 通 过 以 下 命令 可 以 进入 MySQL: 


mal pramee es 


root 是 用 户 名 ，MySQL 自 带 root 用 户 ， 读 者 可 用 自己 的 用 户 名 进入 。 


(5) 输入 命令 后 ， 紧 接着 要 求 输入 密码 。 输 入 用 户 的 密码 后 ， 可 以 看 到 如 图 7.19 所 示 的 
e 


C:\Program Files\MySQL\MySQL Server 5.7Nbin>mysql 
Enter password: 交大 大大 大 

oi to the MySQL monitor. Commands end with 
Your MySQL connection 1d 15 34 


Server version: 5.7.17-log MySQL Community Server 


Copyright (c) 00, 2018, Oracle and/or llates. All rights reserved. 


S d trademark of Oracle Corporation and/ KI 
ther names may be trademarks of their 


' to clear the current input statement. 


图 7.19 HEA MySQL 
(6) 进入 MySQL 后 ， 可 以 通过 输入 “help” 或 者 Ah” AF MySQL 命令 的 帮助 ， 如 图 
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7.20 所 示 。 


图 7.20 MySQL 的 帮助 


(7) 当 我 们 不 需要 使 用 MySQL 时， 可 以 通过 quit 命令 退出 MySQL， 如 图 7.21 所 示 。 


图 7.21 退出 MySQL 


这 里 仅仅 是 对 MySQL 进行 简单 的 介绍 , 读者 可 以 通过 阅读 相关 的 书籍 学 习 与 掌握 更 多 知 


7.3.2 Node.js 连接 MySQL 


Node.js 连接 MySQL 使 用 的 是 mysql 模块 mysql 模块 的 GitHub 地 址 是 https://github.comy 
mysqljs/mysql， 从 中 可 以 阅读 官方 文档 。 使 用 这 个 模块 前 需要 通过 NPM 来 安装 : 


npm install mysql 


mysql 模块 通过 createConnection0 方 法 创建 MySQL 连接 。 如 下 代码 即 和 本 地 的 MySQL 
数据 库 建立 了 连接 。 


【示例 7-15】 
/* 引 入 mysql 模块 */ 


const mysql = require ('mysql'); 


/* 创 建 连接 */ 

const connection = mysql.createConnection (í 
nesE= ocs ityyst r; 
user: rt root 
password : "'secret' 


1); 


134 


第 7 章 Node js 数据 库 开发 


/* 连 接 mysql*/ 
connection connect (Fumctiont(err)ymi 
/* 连 接 出 错 的 处 理 */ 
IE (err) i 
console.error ('error connecting: ' + err.stack); 
IB 1 


} 


console.log("'connected as id ' + connection.threadId); 


【代码 说 明 】 
CreateConnection() 方 法 用 于 创建 连接 ，connection.connect0 方 法 用 于 判断 连接 是 否 成 功 。 
CreateConnection() 方 法 接收 一 个 json 对 象 参 数 。json 对 象 主要 使 用 的 字段 有 : 
host: 需要 连接 数据 库 地 址 ， 默 认为 localhost。 
port: 连接 地 址 默认 的 端口 ， 默 认为 3306。 
user: 连接 MySQL 时 使 用 的 用 尸 名 。 
password: 用 户 名 对 应 的 帘 码 。 
database: 所 需要 连接 的 数据 库 的 名 称 。 
通过 end0 方 法 可 以 正常 终止 一 个 连接 : 


connection.end(function(err) { 


console.log(err); 


}) 


当然 ,使 用 destory(0) 方 法 也 可 以 终止 连接 。 该 方法 会 立即 终止 砍 层 套 接 字 ， 不 会 触发 更 多 
的 事件 和 回调 函数 。 


connection.destory () 


7.3.3 Node.js 操作 MySQL 


连接 MySQL 成 功 后 ， 就 需要 通过 Node.js 来 操作 数据 库 了 。mysql 模块 提供 了 一 个 名 为 
query0O 的 方法 ， 可 以 用 来 执行 SQL 语句 ， 从 而 对 MySQL 数据 库 进 行 相应 的 操作 。 
假设 我 们 连接 的 数据 库 有 一 个 名 为 data 的 数据 表 ， 可 以 使 用 以 下 代码 将 这 个 data 数据 表 
的 所 有 记录 查询 出 来 。 
【示例 7-16】 
/* 引 入 mysql 模块 */ 


const mysql = require('mysql'); 
/* 创 建 连接 */ 


const connection = mysql.createConnection(t{ 
Bost: Localhost., 
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User: "rok", 


password : 'secret', 
database : "database! 


1); 


/* 连 接 mysql*/ 
connection. connect (FUncCETon(err) I 
/* 连 接 出 错 的 处 理 */ 
TE (Err) 
console.error ('error connecting: ' + err.stack); 
Eeturny 


} 


console.log('connected as id ' + connection.threadiId); 


I); 


/* 碍 询 数据 */ 
connection- -query (“SELECT * EROM datat, function(err, rows) | 
TE(SCrTY 1 
console.log (err); 
} else (í 


console.log (rows); 


EE 


运行 这 段 代 码 可 以 看 到 所 有 的 记录 都 被 打印 出 来 了 。 

上 述 代 码 中 connection.query0 方 法 的 第 一 个 参数 是 一 条 SQL 语句 ， 第 二 个 参数 是 一 个 回 
调 图 数 。 回 调 函 数 中 的 第 一 个 参数 是 er， 第 二 个 参数 是 执行 SQL 语句 后 返回 的 记录 。 

connection.query() 方 法 还 有 一 个 paramInfo 参数 可 选 。 当 SQL 语句 中 含有 一 些 变量 的 时 候 ， 
可 以 将 “?” 作 为 占 位 符 放 置 在 SQL 语句 中 ， 通 过 paramInfo 参数 传递 给 SQL 语句 。 


【示例 7-17] 
/* 引 入 mysql 模块 */ 


const mysql = require ('mysql'); 


/* 创 建 连接 */ 
const connection = mysql.createConnection ( 
host: Localhost"; 
user: TOO 
password : 'secret', 
database : "database! 


)); 


/* 连 接 mysq1 * / 
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connection: connect (function (err) [Í 
/* 连 接 出 错 的 处 理 */ 
Te 
console.error('error connecting: ' + err.stack); 
Tes eqe r 
} 
console.log("'connected as id ' + Connection -threadId) ” 
}); 
const table = 'mytable'; 


/* 查 询 数 据 */ 
connection query (SELECT * FROM 2 Itablelr tunction(err; rows) [í 
Tf(err) { 
console.log(err); 
} else { 
console.log (rows); 
} 
}); 


运行 这 段 代 码 ， 同 样 可 以 从 mytable 数据 表 中 取出 所 有 的 数据 记录 。 

mysql 模块 还 提供 了 一 个 escape(0 方 法 ,用 来 防止 SQL 注入 攻击 。SQL 注入 攻击 的 本 质 是 
黑客 在 提交 给 服务 器 的 数据 中 市 有 SQL 语句 , 试图 欺骗 服 务 器 , 让 服务 器 运行 目 己 的 恶意 SQL 
语句 ， 因 此 使 用 escape 方法 处 理 用 户 提 交 的 数据 可 以 防止 SQL 注入 攻击 。 

假设 userid 为 用 户 提 供 的 数据 ， 可 以 先 通 过 connection.escape0 方 法 处 理 一 裔 ， 之 后 再 执 
行 相关 的 SQL 语句 。 


【示例 7-18】 
/* 引 入 mysql 模块 */ 
const mysql = require ('mysql'); 


/* 创 建 连接 */ 

const connection = mysql.createConnection ([ 
Hostel localnaoast u 
user: rm oct 
password : 'secret', 


database : 'database' 


)); 


/* 连 接 mysq1 * / 
connection.connect (function(err) { 
/* 连 接 出 错 的 处 理 */ 
IE (err) i 
console.error ('error connecting: ' + err.stack); 


Pest qirrrz 
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} 


console.log ('connected as id ' + Connection .threadId) ” 


}); 


/* 定 义 SQL 语句 */ 


let sql = 7 SELECT * FROM users WHERE userid=" + connection.escape (userid); 


/* 执 行 SQL 语句 */ 
connection.query(sql, function(err, rows) { 
1 F (err) i 
console.log(err); 
} else { 
console.log(rows); 
l 
}); 


实战 一 一 学 生成 绩 录入 系统 


本 节 将 利用 本 章 前 面 介绍 的 知识 实现 一 个 简单 的 实例 : 创建 一 个 简单 的 学 生成 绩 录 入 系 
统 ， 利 用 MySQL 数据 库 对 学 生成 绩 进行 保存 ， 同 时 利用 Node.js 的 mysql 模块 对 这 个 数据 库 
进行 读 取 。 前 台 主 要 分 为 两 个 页 面 , 一 个 页 和 面 用 于 对 学 生成 绩 进行 录入 ， 男 一 个 页 面 用 来 展示 
所 有 学 生 的 成 绩 。 为 了 提高 开发 速度 ， 整 个 系统 采用 express 这 个 成 熟 的 Node.js 框架 。 


7.4.1 生成 基本 的 项 目 结构 
使 用 express 和 express 生成 器 之 前 需要 通过 NPM 安装 : 


npm install express express-generator -g 


安装 成 功 后 ， 利 用 express 的 生成 费 目 动 生成 基本 的 项 目 结构 。 因 为 这 里 选择 使 用 ejs 模 
板 引 擎 ， 所 以 需要 加 -e 参数 : 


express -e student 


这 时 在 使 用 命令 的 目录 中 会 自动 生成 一 个 名 为 student 的 文件 夹 。 文 件 夹 的 目录 结构 如 图 
7.22 所 示 。 
| | bin 文件 赤 


| | public wik 
加 routes 文件 去 


[Í views 文件 去 
appjs JetBrains WebsSt... 
|] packagejson JSON 文件 


图 7.22 express 生成 器 生成 的 目录 结构 
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在 这 个 目录 的 package.json 中 已 经 声明 了 相关 的 模块 ， 执 行 安装 即 可 : 
npm install 

为 了 使 用 mysql 模块 ， 同 样 需要 通过 NPM 安装 这 个 模块 : 
npm install mysql --save 

整个 项 目 使 用 的 是 ejs 模板 ， 同 样 需要 通过 NPM 安装 这 个 模板 : 


npm install ejs 


7.4.2 数据 库 设 计 


作为 一 个 简单 的 成 绩 录 入 系统 ， 数 据 库 中 存在 的 仅仅 是 学 生成 绩 ， 很 容易 想到 这 里 要 使 
用 字段 学 号 、 学 生 姓名 ,假设 成 绩 只 有 三 个 科目 (语文 、 英 语 和 数学 ) 。 当 然 ， 这 些 字 段 都 不 
能 为 空 。 这 样 可 以 很 容易 地 完成 数据 库 的 设计 ， 如 图 7.23 所 示 。 


| 学 生成 绩 表 
Chinese Field Type Null Key Default Extra 
学 号 ID int NO PRI NULL auto_increment 
姓名 name varchar NO UNI NULL 
语文 chinese int NO 
英语 english int NO 
数学 math int NO 


图 7.23 学 生成 绩 表 结构 
得 到 表 结 构 后 就 需要 在 MySQL 中 创建 啊 应 的 数据 库 与 数据 表 了 。 通 过 命令 行 输入 下 面 的 
代码 ， 束 可 以 创建 相应 的 数据 库 和 数据 表 了 了。 


CREATE DATABASE student; 
USE student; 


CREATE TABLE student ( 

TORENTI REYTAUTORINCREMENIS 

name VARCHAR (20) NOT NULL UNIQUE, 
chinese INT NOT NULL, 

english INT NOT NULL, 

math INT NOT NULL 

); 


全 此 ， 学 生成 绩 的 数据 库 和 数据 表 已 经 建立 。 


7.4.3 ”成绩 录入 路 由 开发 
这 里 将 router 文件 夹 下 的 index 文件 作为 成 绩 录入 的 路 由 。 这 个 路 由 的 功能 有 两 个 : 一 个 
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是 显示 成 绩 录 入 的 页 面 ， 另 一 个 是 通过 这 个 路 由 来 保存 相应 的 学 生成 绩 数 据 。 很 明显 ， 这 里 可 
以 根据 HTTP 方法 来 实现 ， 前 者 是 GET 方法 ， 后 者 是 POST 方法 。GET 方法 仅仅 是 获取 一 个 


页 和 面 。 


既然 需要 使 用 数据 库 , 首先 要 与 数据 库 创建 相应 的 连接 。 在 项 目 目录 中 新 建 一 个 名 为 dbjs 


的 文件 ， 根 据 本 章 前 面 所 讲 的 相关 知识 建立 MySQL 数据 库 连 接 : 


const mysql=require ("mysql"); 


const DB={ 


hoest=- localnosta, 
port 353067 

USET moc 
password:"xie1l38108", 


database:"student" 


const DBConnection=mysql.createConnection({ 


I); 


bpost-:DB:Ipost; 
user:DB.user, 
POTE: BES POTE; 
password:DB.password, 
database:DB.database, 


multipleStatements:true 


PBCorirect Ton correct () ; 


module.exports.DBConnection=DBConnection; 


通过 模块 的 导出 将 使 得 这 个 数据 库 模 块 更 加 通用 。 


成 绩 录入 的 模块 GET 方法 依旧 使 用 express 目 定 义 的 模板 index, HH router 文件 夹 下 的 


index.js 文件 改 为 以 下 代码 : 


Var 


Vi t 


Var 


Expressi en (express) 
qb = requires". /db els 


router = express.Router () ; 


router.get('/', function(req, res, next) { 


res render("index")rç 


1); 


module. .exports = router; 
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据 存 进 数 据 库 中 。 前 端 传送 的 数据 是 存在 req.body 对 象 中 的 ， 可 以 利用 这 一 点 将 数据 获取 下 
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来 ， 结 合 响应 的 SQL 语句 和 mysql 模块 的 query0 方 法 将 数据 保存 在 相应 的 数据 库 中 。POST 
方法 的 代码 如 下 : 


IOUter Dostl"/", function(regr, res, mext) | 
var mysqlParams=[req.body.name, 
req.body.chinese, 
req.body.english, 
req.body.math 
Ez 
var mysqlQuery = 'INSERT student (name, chinese,english,math) VALUES (?,?,?,?)' 
db.DBConnection.query (mysqlQuery,mysqlParams, function (err,rows,fields)t 
if (err) 
console.log (err); 
Ee 
} 


var success=t{ 


message: "增加 成 功 " 
}; 
res .send (success); 
Fk; 
The 


这 样 成 绩 录 入 的 路 由 就 开发 完毕 了 。 


7.4.4” 读 取 学 生成 绩 路 由 开发 


这 里 使 用 router 文件 夹 下 的 user.js 作为 路 由 。 很 明显 ， 这 个 路 由 只 需要 使 用 一 个 GET 方 
法 即 可 。 

简单 的 思路 是 用 户 获 取 这 个 页 面 之 后 ， 后 端 啊 应 对 MySQL 数据 库 进 行 查 询 ， 将 查询 得 到 
的 数据 传递 给 模板 引擎 处 理 ， 从 而 温 染 出 完整 的 页 面 。 相关 的 知识 前 文 已 经 介绍 过 , 这 里 直接 
给 出 这 个 路 由 的 代码 。 
var express = require("express'); 


var do = rëgaire (*. 7 /db Ts Ys 
var router = express.Router () ; 


router.get('/', function(req, res, next) [Í 


var mysqlQuery = 'SELECT * FROM student ' 
db.DBConnection.query (mysqlQuery, function (err, rows, fields){ 
JE (err hl 


console.log (err); 
Teturr; 


) 


res.render('user', {students:rows}) 
}); 
I); 
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module.exports = router; 


最 后 ， 利 用 命令 行 运行 appjs 文件 便 可 以 局 动 项 目 了 。 整 个 前 台 页 面 如 图 724 和 图 7.25 


所 示 。 
学 生成 绩 录入 
姓名 
语文 
英语 
数学 


图 7.24 学 生成 绩 录 入 页 面 


学 生成 绩 查 询 


图 7.25 学 生成 绩 查询 页 面 


当然 ， 实 现 这 样 一 个 页 面 需 要 读者 掌握 基本 的 HTML 和 CSS 知识 。 读 者 可 以 目 行 通 过 阅 
读 相应 的 书籍 进行 学 习 与 掌握 。 


jD 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 

1. 如 何 通 过 mongoose 连接 和 操作 MongoDB? 

2. 如 何 通过 node-mongodb-native 连接 和 操作 MongoDB? 
3. 如 何 通过 mysql 模块 连接 和 操作 MySQL? 

4. 什么 是 SQL 注入 ? 

5. 如 何 使 用 express 生成 器 快速 生成 一 个 项 目 ? 

6. ejs 模板 引擎 的 基本 使 用 方法 是 什么 ? 
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目前 使 用 Node.js 技术 的 人 大 都 是 前 端 人 员 。 如 今 前 端 技术 发 展 迅 速 ， 了 解 当 前 的 主流 前 
疹 开 发 技术 是 每 个 Web 开发 人 员 的 必修 课 。 
通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 
使 用 jQuery 快速 操作 DOM. 
了 解 React 的 使 用 和 基本 概念 。 
完成 一 个 简单 的 React 页 面 。 


前 端 框 架 介 绍 一 一 jQuery 


jQuery 是 一 个 快速 、 简 洁 的 JavaScript 框架 ， 是 继 Prototype 之 后 又 一 个 优秀 的 JavaScript 
代码 库 〈 或 JavaScript 框架 ) 。jQuery 设计 的 守则 是 “Write Less, Do More”， 即 倡导 写 更 少 
的 代码 ， 做 更 多 的 事情 。 
8.1.1 jQuery 介绍 


jQuery 的 官方 网 站 ( 见 图 8.1) 地 址 为 https://jquery.com/，GitHub 地 址 为 https://github.com/jquery/ 
Jquery 。 


Download jQuery 
v3.3.1 


The ls and Zx bromhes no banger sertie patrhes- 


What is jQuery? 


wery 5 a fast, small, and feature-nch JavaScnpt ibrary It makes things like HTML document traversal and 
manipulation, event handling, animation, and Ajax much simpler with an easy-to-use API that works across a muttuje 
a p d atens a 
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图 8.1 jQuery 官方 网 站 
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jQuery 诞生 于 2007 年 ， 经 过 十 多 年 的 发 展 已 经 成 为 每 一 个 前 端 人 员 必 备 的 技能 。jQuery 


对 DOM 操作 的 封装 甚至 使 很 多 初 涉 前 端 领 域 的 人 只 知 jQuery， 不 知 原生 JavaScript. fF BH 
这 个 日 新 月 异 的 领域 ，jQuery 在 十 多 年 中 依旧 受到 大 量 编程 人 员 的 追捧 ， 不 得 不 说 这 是 一 个 
奇迹 。 


jQuery 简化 了 开发 人 员 操 作 DOM, 处理 事件、 执行 动画 和 开发 Ajax 的 操作 ， 同 时 这 些 


操作 对 浏览 器 都 是 兼容 的 。 这 种 简化 改变 了 前 痛 编 程 人 员 的 代码 设计 思路 和 编程 方式 ， 同 时 极 
大 地 提高 了 前 端 开 发 人 员 的 生产 力 。 


JQuery 的 主要 特点 有 : CHE, 压缩 后 大 小 在 30KB £A; GO 强大 的 选择 器 ; (3) 链 式 操 作 ; 


由 优雅 的 动画 ; OHEAK DOM 封装 ，G@@) 兼 容 主 流 浏览 器 。 


获取 jQuery 的 方式 非常 简单 ， 可 以 从 jQuery 官方 网 站 中 选择 相应 的 版 本 进行 下 载 。 下 载 


之 后 可 以 选择 开发 版 或 者 生产 版 进行 使 用 。 只 需要 像 使 用 其 他 普通 的 JavaScript 脚本 一 样 ， 使 
用 script 标签 进行 引入 : 


<script type "text/javascript" src="scripts/jquery.js"></script> 


8.1 


FLA ZJE PUS hi ë H] jQuery 了 。 


2 ”使 用 jQuery 选择 器 


jQuery 中 的 选择 器 完全 继承 了 CSS 的 风格 。 这 样 就 可 以 非常 方便 地 使 用 jQuery 选择 器 快 


速 找 出 特定 的 DOM 元 素 ， 从 而 对 DOM 元 素 进行 相应 的 操作 或 者 添加 相应 的 行为 。 得 益 于 
jQuery 的 浏览 器 兼容 性 处 理 , 使 用 这 些 jQuery 的 选择 器 完全 不 需要 担心 浏览 器 的 兼容 性 问题 。 


jQuery 选择 器 主要 可 以 分 为 以 下 几 类 。 
1. 基本 选择 器 
$("#id"): id 选择 器 ， 返 回 单个 元 素 。 
$(".class"): class 选择 器 ， 返 回 集合 元 素 。 
$("element"): 选 定 指定 的 元 素 名 匹配 的 元 素 ， 返 回 集合 元 素 。 
$("*"): 通配符 选择 器 ， 选 择 所 有 元 素 ， 返 回 集合 元 素 。 
$("selectorl,selector2"): 选择 所 有 选择 器 匹配 的 元 素 ， 返 回 集合 元 素 。 
层次 选择 器 。 
$("ancestor descendant"): 选择 ancestor 元 素 的 所 有 descendant 后 代 元 素 ， 返 回 集合 元 素 。 
$("parent>child"): 选择 parent 下 的 child 子 元 素 。 
$("prev+next"): 选择 紧 接 在 prev 后 面 的 同辈 next 元 素 。 
$("prev~siblings"): 获取 prev 后 面 的 所 有 同辈 siblings 元 素 。 


其 中 ，S$("prevt+next") 与 $("prev").nextO 的 效果 相同 ，$("prev~siblings") 与 $("prev").sibling() 


e © o° N @ @ @ 


的 效果 相同 。 


146 


3. 基本 过 滤 选 择 器 


© °@ @ E @ @ O @ @ @ 0 @ @  @ ® O— @  @  @ ©。 @ @° @ @ O@ eg@ @ 


first: 选取 第 一 个 元 素 ， 返 回 单个 元 素 。 

Jast: 选取 最 后 一 个 元 素 ， 返 回 单个 元 素 。 

:not(selector): 去 除 所 有 给 定 选 择 器 所 匹配 的 元 素 ， 返 回 集合 元 素 。 

:even: 选取 索引 为 偶数 的 所 有 元 素 ， 索 引号 从 0 开始， 返回 集合 元 素 。 
:odd: 选取 索引 为 奇数 的 所 有 元 素 ， 索 引号 从 0 开始 ， 返 回 集合 元 素 。 
:ep(index): 选取 索引 等 于 index 的 元 素 ，index 从 0 开始， 返回 单 个 元 素 。 
:gt(index): 选取 索引 大 于 index 的 所 有 元 素 ， 返 回 集合 元 素 。 

:lt(index): 选取 索引 小 于 index 的 所 有 元 素 ， 返 回 集合 元 素 。 

:header: 选取 所 有 的 标题 元 素 ， 返 回 集合 元 素 。 

:animated: 选取 正在 执行 动画 的 元 素 ， 返 回 集合 元 素 。 


内 容 过 滤 选 择 器 


:contains(text): 选取 含有 文本 内 容 为 text 的 元 素 ， 返 回 集合 元 素 。 
:empty: 选取 没有 子 节 点 或 者 文本 的 空 元 素 ， 返 回 集合 元 素 。 
:has(selector): 选取 含有 选择 器 所 匹配 的 元 素 ， 返 回 集合 元 素 。 
:parent: 选取 含有 子 节点 或 者 文本 的 元 素 ， 返 回 集合 元 素 。 


可 见 性 过 滤 选 择 器 


:hidden: 选取 所 有 不 可 见 的 元 素 ， 返 回 集合 元 素 。 
:Visible: 选取 所 有 可 见 的 元 素 ， 返 回 集合 元 素 。 


属性 过 滤 选 择 器 


[attribute]: 选取 含有 此 属性 的 元 素 ， 返 回 集合 元 素 。 

:[attribute=value]: 选取 属性 的 值 为 value 的 元 素 ， 返 回 集合 元 素 。 

-[attribute!—value]: 选取 属性 的 值 不 为 value 的 元 素 ， 返 回 集合 元 素 。 
:[attribute^=value]: 选取 属性 的 值 以 value 开始 的 元 素 ， 返 回 集合 元 素 。 
:[attribute$=value]: 选取 属性 的 值 以 value 结尾 的 元 素 ， 返 回 集合 元 素 。 
:[attribute*=value]: 选取 属性 的 值 含有 value 的 元 素 ， 返 回 集合 元 素 。 
:[attribute|=value]: 选取 属性 的 值 等 于 value 或 者 以 value 为 前 组 ( 即 “value-”，value 
后 面 跟 一 个 连 字 符 ) 的 元 素 ， 返 回 集合 元 素 。 


:[attribute~=value]: 选取 属性 以 空格 分 隔 的 值 中 含有 value 的 元 素 ， 返 回 集合 元 素 。 
-[attribute1][attribute1]... ...[attributeN1]: 用 多 个 属性 选择 器 合并 成 一 个 复合 属性 选择 
器 ， 返 回 集合 元 素 。 
子 元 素 过 滤 选 择 器 
:nth-child(index/even/odd): 选取 父 元 素 下 的 第 index 个 子 元 素 ，index 值 从 1 开始 ,或 
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者 选取 奇 、 偶 子 元 素 ， 返 回 集合 元 素 。 
© `first-child: 选取 父 元 素 下 的 第 一 个 子 元 素 ， 返 回 集合 元 素 。 
© :last-child: 选取 父 元 素 下 的 最 后 一 个 子 元 素 ， 返 回 集合 元 素 。 
© :only-child: 如 果 元 素 是 父 元 素 的 唯一 元 素 就 选择 ， 否 则 不 选择 ， 返 回 集合 元 素 。 


另外 ，:nth-child0 还 可 以 通过 数学 表达 式 选 取 一 组 特定 的 元 素 ， 如 :nth-child(3mn) 就 选取 父 


元 系 下 所 有 3 的 倍数 的 子 元 素 (n 从 1 开始 ， 即 选取 第 3、6、9…… 个 元 素 ) o 


8.1. 


8. 表单 选择 器 


:input: 选取 所 有 的 input. textarea, select. button 元 素 ， 返 回 集合 元 素 。 
text: 选取 所 有 的 单行 文本 框 ， 返 回 集合 元 素 。 
:password: 选取 所 有 的 密码 框 ， 返 回 集合 元 素 。 
:Tadio: 选取 所 有 的 单 选 框 ， 返 回 集合 元 素 。 
:checkbox: 选取 所 有 的 多 选 框 ， 返 回 集合 元 素 。 
:submit: 选取 所 有 的 提交 按钮 ， 返 回 集 合 元 素 。 
:image: 选取 所 有 的 图 像 按 钮 ， 返 回 集合 元 素 。 
:Teset: 选取 所 有 的 重 置 按 钮 ， 返 回 集合 元 素 。 
:button: 选取 所 有 的 按钮 ， 返 回 集合 元 素 。 
:file: 选取 所 有 的 上 传 域 ， 返 回 集 合 元 素 。 
表单 对 象 属性 过 滤 选 择 器 
:enabled: 选取 所 有 可 用 元 素 ， 返 回 集合 元 素 。 
:disabled: 选取 所 有 不 可 用 元 素 ， 返 回 集合 元 素 。 
:checked: 选取 所 有 被 选中 的 元 素 ( 单 选 框 和 多 选 框 ) ， 返 回 集合 元 素 。 
:selected: 选取 所 有 被 选中 的 元 素 (下 拉 列 表 ) ， 返 回 集合 元 素 。 


e © @ CO @e © © @ © O@ © ©。 @ 


3 使 用 jQuery 进行 DOM 操作 
原生 JavaScript 对 于 DOM 的 操作 非常 复杂 ， 而 且 各 大 浏览 器 对 于 DOM 的 实现 标准 也 不 


一 样 ， 因 此 造成 原生 JavaScript 在 DOM 操作 方面 如 同 鸡肋 一 般 ， 不 过 jQuery 为 我 们 提供 了 大 
量 简洁 的 DOM 操作 方法 。 
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1. 查找 和 设置 相应 属性 的 方法 

@ attr(0 方 法 : 接收 一 个 或 两 个 参数 (一 个 参数 时 用 于 获取 属性 值 ， 两 个 参数 时 用 于 设置 
属性 )。 需 要 设置 多 个 属性 时 ,attr 方法 的 参数 可 以 是 一 个 由 属性 和 属性 值 组 成 的 json 
数据 格式 。 

@ css( 方 法 : 接收 一 个 或 两 个 参数 ( 当 一 个 参数 是 属性 名 时 ， 获 取 属 性 值 ; 当 接收 两 个 
参数 时 ， 设 置 属性 第 一 个 参数 为 属性 名 ， 第 二 个 参数 为 属性 值 ) 。 需 要 设置 多 个 属性 
BT, css 方法 的 参数 可 以 是 一 个 由 属性 和 属性 值 组 成 的 json 数据 格式 。 


addClass): 为 元 素 添加 class 值 ， 可 批量 添加 属性 与 值 。 

removeAttr0: 删除 指定 的 属性 。 

removeClass(): 有 参数 时 ， 删 除 指定 的 class 值 ; 没有 参数 时 ， 删 除 全 部 的 class 值 。 
hasClass): 判断 匹配 的 元 素 是 否 有 某 个 class 值 ， 有 就 返回 tue， 没 有 则 返回 false. 


2. 创建 元 素 、 文 本 、 属 性 节 扣 的 方法 
可 以 直接 将 元 素 、 文 本 、 属 性 添加 到 $0 方 法 中 ， 例 如 : 
p=$ ("<p title='mytitle'> 假 装 是 标题 </p>" 


3. 插入 节点 的 方法 


> @ ° e° @ 


append(): 向 元 素 内 部 添加 节点 。 

appendTo(): 将 元 素 添加 到 指定 元 素 内 部 ， 即 将 append 方法 中 的 链 式 操作 成 员 互 换 
位 置 。 

prepend(): 向 元 素 内 部 前 置 内 容 。 

prependTo(): 将 节点 前 置 到 指定 元 素 中 ， 即 将 prepend 方法 链 式 操作 中 的 成 员 互 换 位 
EK. 

after): 在 每 个 元 素 节 点 后 添加 节点 。 

insertAfter(): 将 节点 插入 指定 节点 之 后 ， 即 将 after 方法 链 式 操作 中 的 成 员 互 换 位 置 。 
before): 在 节点 前 面 插入 节点 。 

insertBeforeO: 将 节点 插入 指定 元 素 前 面 。 


删除 节点 的 方法 


remove(): 从 DOM 中 删除 所 有 匹配 的 元 素 ， 同 时 该 节点 所 包含 的 所 有 后 代 节 点 将 同 
时 被 删除 ， 因 为 返回 值 是 删除 节点 的 引用 ， 所 以 可 以 在 以 后 继续 使 用 这 些 元 素 , 但 是 
这 些 节 点 所 绑 定 的 事件 也 会 删除 。 

detach): 和 remove0 几 乎 一 样 ， 不 同 的 是 detach 方法 不 会 删除 节点 所 绑 定 的 事件 和 
附加 的 数据 。 

empty0: 清空 所 匹配 的 节点 。 


5. 复制 节点 的 方法 


clone): 复制 节点 ， 可 以 有 trme 参数 。 当 有 true 参数 时 ， 将 同时 复制 节点 所 绑 定 的 事件 。 


6. 蔡 换 节操 的 方法 


© replaceWith(): 将 匹配 的 节点 替换 成 指定 的 节点 。 

©  IeplaceAll0: 用 指定 的 节点 替换 相应 节点 ， 即 将 replaceWith 方法 链 式 操作 中 的 成 员 
互 换 位 置 。 

7. 遍历 节点 

© children): 获取 所 有 的 子 元 素 集合 ， 返 回 一 个 数组 ， 只 考虑 子 元 素 ， 不 考虑 其 他 后 代 
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元 素 。 

next(): 获取 匹配 元 素 后 面 紧邻 的 同 华 元 素 ， 效 果 类 似 于 $("prevtnext")。 
prevO: 获取 匹配 元 素 前 面 紧 邻 的 同辈 元 素 。 

siblings): 获取 匹配 元 素 前 后 所 有 的 同辈 元 素 ， 类 似 于 $("prev~siblings'")。 
closest): 获取 最 近 的 符合 匹配 的 一 个 父 元 素 。 

parent): 获取 一 个 父 元 素 。 

parents): 获取 所 有 匹配 的 一 个 祖先 元 素 。 
事件 与 动画 


加 载 DOM 使 用 $(document).ready(), 和 原生 的 JavaScript 的 window.onload0 方 法 有 类 
似 的 功能 。window.onload() 方 法 是 在 网 页 中 所 有 的 元 素 ( 包括 元 素 的 所 有 关联 文件 ) 
完全 加 载 到 浏览 器 后 才 执 行 ; $(documenbreadyO 在 DOM 完全 就 绪 时 就 可 以 被 调用 ， 
此 时 并 不 意味 着 这 些 关联 文件 都 已 经 下 载 完 毕 。 另 外 ，$(documenbreadyO 可 多 次 使 
A), m window.onloadO 只 能 使 用 一 次 ， 多 次 使 用 时 会 出 现 履 盖 的 现象 。 除 此 之 外 ， 
$(document).ready 可 以 简写 成 $Oready0O。 

© 事件 绑 定 使 用 bind0， 可 以 有 三 个 参数 ， 第 一 个 参数 是 事件 类 型 ， 第 二 个 参数 可 选 ， 
作为 event.data 属性 值 传 给 事件 对 象 的 额外 数据 对 象 ， 第 三 个 参数 是 处 理 函 数 。 


和 常见 的 事件 类 型 有 blur、focus、load、reslize、scroll、unload、click、dbclick、mousedown、 
mouseup, mouseover, mousemove, mouseout, mouseenter、 mouseleave、 change, select, submit. 


keydown, keyup, errore F:rB, mouseover, mouseout 这 类 第 用 的 事件 可 以 简 与 : 


SENECO] 


@ceeeeg@ eg@ @ 


sf)EmosecowemrEoncEomry 
S (this) .next () .show() 

|) mouseout [ turict ron () í 
S(Lhisy next () hide () 

1) 


9. 合成 事件 
jQuery 中 有 两 个 合成 事件 hover0 和 toggle0 方 法 。 
© hover): 用 于 模拟 光标 悬 停 事 件 ， 语 法 : 


hover (enter, leave); 
当 光 标 移动 到 元 素 时 会 触发 第 一 个 图 数 ， 离 开 时 触发 第 二 个 图 数 。 
© toggle): 用 于 模拟 鼠标 连续 点 击 事件 ， 语 法 : 


toggle AD ENZ a sEm)? 
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前 端 框架 介绍 一 一 React 


React 起 源 于 Facebook 的 内 部 项 目 。React 的 出 现 是 革命 性 的 创新 ， 它 的 横 空 出 世 使 全 球 

的 JavaScript 开发 者 为 之 状 狂 , 可 以 说 React 是 一 个 颠覆 式 的 前 问 框 架 。React 官方 这 样 介绍 它 : 

-个 声明 式 的 、 高 效 的 、 灵 活 的 、 创 建 用 户 界 面 的 JavaScript 库 。 虽 然 React 的 主要 作用 是 构 
È UI， 但 是 项 目的 逐渐 成 长 已 经 使 得 React 成 为 前 后 端 通 吃 的 Web App 解决 方案 。 


8.2.1 React 介绍 


React 的 官方 网 址 为 https://facebook.github.io/react/ (H Hi WL B| 8.2) , GitHub 地 址 为 
https://aithub.com/facebook/react。 


WHO WREE SEV 历史 (5) 书签 日 IRM 帮助 (H) 


* React- A JavaScript library for X 一 


e)> x @ © 自 hiipsyreacisorg 


building user interfaces 


clarative Component-Based Learn Once, Write Anywhere 


React makes it painless to create interactive Uls. Build encapsulated components that manage We don t make assumptions about the rest of 
thelr own state, then compose them to make your technology stack, so you can develop new 
features in React without rewriting existing 
render just the right components when your 
data changes, 
eadt can also render on the server using Node 
Declarative views make your coda more data through your app and kee 2 put o and power mobile apps using React Native 
predictable and easier to debug. the DOM 


FES platform.tvatter.com... 


图 8.2 React 官方 网 站 


React 的 声明 式 特点 减少 了 操作 DOM 的 性 能 损耗 ， 同 时 利用 项 目的 解 耦 、 项 目 人 员 的 相 
互 配合 以 及 同时 组 件 化 开发 思想 使 得 大 量 组 件 得 以 复 用 。React 内 部 实现 的 虚拟 DOM 和 DOM 
diff 算法 使 得 对 DOM 的 操作 变 得 十 分 高 效 。 我 们 知道 在 JavaScript 中 一 个 DOM 节点 有 很 多 
的 属性 和 方法 ， 在 开发 者 工具 中 ， 可 以 使 用 for...in... 语 句 打 印 出 这 些 属性 和 方法 ， 如 图 8.3 
所 示 。 
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undefined 
var value 
C undefined 


for(var key in div)( 
value += key +' '; 


} 


é "align title lang translate dir dataset hidden tabIndex accessKey draggable spellcheck contentEditable isContentEditable offsetParent 
offsetTop offsetLeft offsetWidth offsetHeight style innerText outerText onabort onblur oncancel oncanplay oncanplaythrough onchange 
onclick onclose oncontextmenu oncuechange ondblclick ondrag ondragend ondragenter ondragleave ondragover ondragstart ondrop 
ondurationchange onemptied onended onerror onfocus oninput oninvalid onkeydown onkeypress onkeyup onload onloadeddata onloadedmetadata 
onloadstart onmousedown onmouseenter onmouseleave onmousemove onmouseout onmouseover onmouseup onmousewheel onpause onplay onplaying 
onprogress onratechange onreset onresize onscroll onseeked onseeking onselect onshow onstalled onsubmit onsuspend ontimeupdate ontoggle 
onvolumechange onwaiting click focus blur onauxclick ongotpointercapture onlostpointercapture onpointercancel onpointerdown onpointerenter 
onpointerleave onpointermove onpointerout onpointerover onpointerup namespaceURI prefix localName tagName id className classList slot 
attributes shadowRoot assignedSlot innerHTML outerHTML scrollTop scrollLeft scrollWidth scrollHeight clientTop clientLeft clientWidth 
clientHeight onbeforecopy onbeforecut onbeforepaste oncopy oncut onpaste onsearch onselectstart onwheel onwebkitfullscreenchange 
onwebkitfullscreenerror previousElementSibling nextElementSibling children firstElementChild lastElementChild childElementCount 
hasAttributes getAttribute getAttributeNS setAttribute setAttributeNS removeAttribute removeAttributeNS hasAttribute hasAttributeNS 
getAttributeNode getAttributeNodeNS setAttributeNode setAttributeNodeNS removeAttributeNode closest matches webkitMatchesSelector 
attachShadow getElementsByTagName getElementsByTagNameNS getElementsByClassName insertAdjacentElement insertAdjacentText 
insertAdjacentHTML requestPointerLock getClientRects getBoundingClientRect scrollIntoView scrollIntoViewIfNeeded createShadowRoot 
getDestinationInsertionPoints animate remove webkitRequestFullScreen webkitRequestFullscreen querySelector querySelectorAll 
setPointerCapture releasePointerCapture hasPointerCapture before after replaceWith prepend append ELEMENT_NODE ATTRIBUTE_NODE TEXT_NODE 
CDATA_SECTION_NODE ENTITY_REFERENCE_NODE ENTITY_NODE PROCESSING_INSTRUCTION_NODE COMMENT_NODE DOCUMENT_NODE DOCUMENT_TYPE_NODE 
DOCUMENT_FRAGMENT_NODE NOTATION_NODE DOCUMENT_POSITION_DISCONNECTED DOCUMENT_POSITION_PRECEDING DOCUMENT_POSITION_FOLLOWING 
DOCUMENT_POSITION_CONTAINS DOCUMENT_POSITION_CONTAINED_BY DOCUMENT_POSITION IMPLEMENTATION_ SPECIFIC nodeType nodeName baseURI isConnected 
ownerDocument parentNode parentElement childNodes firstChild lastChild previousSibling nextSibling nodeValue textContent hasChildNodes 
getRootNode normalize cloneNode isEqualNode isSameNode compareDocumentPosition contains lookupPrefix lookupNamespaceURI isDefaultNamespace 
insertBefore appendChild replaceChild removeChild addEventListener removeEventListener dispatchEvent " 


图 8.3 DOM 节点 的 属性 和 方法 


一 个 DOM 和 一 个 JavaScript 对 象 非常 像 ， 包 含 tagName、 属 性 、 子 节点 等 。 因 此 ， 可 以 
用 JavaScript 对 象 来 表示 DOM 节点 。 虚 拟 DOM 就 是 这 个 思路 , 根据 DOM diff 算法 得 出 变化 
的 DOM， 最 后 应 用 于 真实 的 DOM， 从 而 尽 可 能 减少 DOM 操作 的 开销 。 

React 只 是 专注 于 UI 的 构建 ， 因 此 构建 大 型 应 用 还 需要 配合 其 他 技术 栈 一 起 使 用 ， 这 也 
正 是 React 的 灵活 性 体现 。 


(1) 为 了 减少 React 应 用 开发 环境 搭建 的 烦琐 ， 可 以 使 用 Facebook 官方 推出 的 
create-react-app 脚手架 工具 。 要 使 用 create-react-app， 需 要 使 用 Node.js 在 全 局 安装 这 个 脚 手 
染 ， 代 码 如 下 : 


npm install create-react-app -g 


(2) 安装 完成 后 ， 就 可 以 使 用 create-react-app 工具 初始 化 一 个 React 项 目 了 。 可 以 使 用 
以 下 命令 初始 化 一 个 项 目 : 


create-react-app projectname 


(3) 命令 运行 完成 后 的 界面 如 图 8.4 所 示 。 


84 初始 化 界面 
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(4) 根据 提示 的 运行 命令 ， 进 入 项 目 目录 后 ， 使 用 npm start 命令 可 以 运行 这 个 项 目 。 运 
行 后 ， 可 以 在 浏览 器 中 输入 localhost:3000 地 址 ， 从 而 看 到 这 个 项 目 初始 化 的 样子 ， 如 图 8.5 
所 示 。 


Welcome to React 


To get started, edit src/App. js and save to reload. 


8.5 React 欢迎 界面 


(5) 进入 项 目 目录 后 可 以 看 到 这 个 create-react-app 创建 的 文件 和 文件 夹 ， 如 图 8.6 所 示 。 


Name Date modified Type 


018/9 


B node_modules 
public 
src 


8/ File folder 
4] .gitignore 2018/ 


File folder 


File folder 


( 
; > 4 AN 
9/13 10:40 
2 1 ADD) 
3/ |3 UU 


~ 


"A 


fT packagejson 9; JSON File 


一 


fT package-lock.json 
<| README.md 


JSON File 


1 
1 
1 
13 10:40 Git Ignore Source ... 
1 
1 
1 


Q 


Markdown Source... 


图 8.6 craete-react-app 初始 化 目录 


其 中 需要 重点 关注 的 是 src 文件 来 。 这 个 文件 夹 是 开发 的 文件 来， 所 有 的 React 组 件 都 应 
该 存放 在 这 个 文件 夹 中 。src 文件 夹 的 文件 目录 如 图 8.7 所 示 。 


Name Date modified Type 


ËJ] App.css 2018/9/13 10:40 JetBrains WebSto 
= App.js 018/9/13 10:40 JetBrains WebStorm 
EJ App.test.js 2018/9/13 10:40 JetBrains WebStorn 
= index,css 2018/9/13 10:40 JetBrains WebStorn 
= index.js 2018/9/13 10:40 J s WebSto 


ocument 


018/9/13 10:40 JetBrains WebStor 
图 8.7 src 目录 
在 src 目录 中 ，index.js 是 整个 项 目的 入 口 文件 ， 定 义 了 泻 染 的 public 文件 来 下 index.html 
文件 对 应 的 DOM 节点 ， 文 件 内 容 如 下 : 
import React from 'react'; 
import ReactDOM from 'react-dom'; 
import App From eT 


import registerServiceWorker from './registerServiceWorker'; 


import '. index. css"; 


ReactDOM. render (<App />, document.getElementBylId('root'));/ 
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reg TSECErCSEENTEENOCREENIS 


利用 create-react-app 脚手架 工具 使 开发 React 应 用 免 去 了 开发 环境 搭建 的 烦琐 ， 只 需要 在 


src 进行 开发 就 好 了 。create-react-app 也 提供 了 npm run build 命令 来 生成 生产 环境 文件 。 
这 个 命令 会 将 所 有 的 JS 文件 打包 压缩 为 一 个 JS 文件 ， 用 于 生产 环境 。 


8.2.2 ”React 的 JSX 语言 


在 传统 的 Web FREF, HE3 HTML 与 JavaScript 文件 分 离 。Facebook 却 认为 组 件 才 是 
Web 开发 中 最 重要 的 。 为 了 将 HTML 文件 可 以 谋 入 JavaScript 代码 中 ，Facebook 拓展 了 
JavaScript 这 门 语言 ， 形 成 了 JSX 语言 。 

可 以 在 JavaScript 文件 中 正常 写 入 HTML 代码 。 在 上 一 小 节 中 生成 的 React 项 目 src 文件 
夹 下 的 Appjjs 文件 内 容 如 下 : 


import React, { Component } from 'react'; 
import Togo trom " logo Sv 


import "MADD Cede 


class App extends Component { 
render() 
return ( 
<div className="App"> 
<div className="App-header"> 
<img src={logo} className="App-logo" alt="logo" /> 
<h2>Welcome to React</h2> 
</div> 
<p className="App-intro"> 
To get started, edit <code>src/App.js</code> and save to reload. 
</p> 
</ div> 
); 


export default App; 


在 这 个 文件 中 ，render() 方 法 可 以 像 在 HTML 文件 中 一 样 书写 HTML 代码 ， 这 便 是 JSX 
语言 。 当 然 JSX 语言 并 不 是 开发 React 所 必需 的 。 不 使 用 JSX， 可 以 使 用 React.createElement() 
方法 来 创建 HTML 节点 ， 不 过 这 个 方法 远 没 有 JSX 语言 简明 易 读 ， 因 此 开发 中 强烈 建议 使 用 
JSX 语言 。 

使 用 JSX 需要 注意 的 是 ，class 为 JavaScript 语言 的 保留 字 ， 应 该 使 用 className 来 代 蔡 ， 
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同时 HTML 的 for 属性 也 是 JavaScript 的 保留 字 ， 应 该 使 用 htmlFor 来 代 蔡 。 

在 JSX 语言 中 ， 可 以 像 HTML 文件 一 样 正 贡 书写 HTML 标签 。 如 果 需 要 在 一 段 HTML 
标签 中 使 用 JavaScript 语言 ， 束 需要 使 用 大 括号 “人 ”来 包围 JavaScript 代码 ， 告 诉 编译 工具 
这 些 是 JavaScript 代码 ， 有 具体 如 下 : 


const divy — dv LO </div>; 


值得 注意 的 是 ，JSX 中 style 属性 应 该 作为 一 个 对 象 ， 因 为 对 象 是 JavaScript 的 语法 ， 所 以 
又 需要 使 用 大 括号 包围 。 同 时 ，css 属性 也 不 再 是 使 用 中 国 线 连接 ， 而 是 使 用 驼峰 形式 ， 因 此 
声明 一 个 元 素 的 style 可 能 如 下 : 


const div = <div ' style= {IfontSize: "16px"; textAlign: 'center']]> [1+100] </div>; 


在 实际 开发 中 , 一 段 列 表 (如 文章 列表 ) A E 6 BL. 得 益 于 JSX 语言 , 利用 JavaScript 
的 循环 迭代 可 以 迅速 生成 一 段 列 表 ， 而 不 再 是 一 大 段 一 大 段 关 似 的 列表 元 系 。 在 JSX 中 可 以 
使 用 数组 来 存储 一 组 元 素 , 最 后 利用 大 括号 展开 即 可 。 例 如 , 实现 一 段 简单 的 列表 , 修改 App.js 
文件 如 下 : 


/* 引 入 React*/ 
import React, { Component } from "react'; 
PIARA 


ioport ' App Cas 


/* 构 建 App 类 */ 
class App extends Component { 
/* 定 义 render 方法 */ 
render() { 
Const arr | react! javascript; java r TUDY; "php; 
const eleArr = arr-map((ele i) => { 
return <li key={i}> {ele} </li> 
}); 
/* 返 回 j sx 内 容 */ 
return ( 
<div className="App"> 
<ul> 
{eleArr} 
= p 41 


< di y> 


} 


/* 导 出 APP 类 */ 


export default App: 
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EN RAP A AES BRIRIKA ER S, WB 8.8 所 示 。 


react 
javascript 
java 
ruby 
php 


图 8.8 快速 生成 列表 


如 此 生成 的 元 素 应 该 始终 带 有 key 属性 。 这 个 属性 是 React 为 了 标明 不 同 元 素 ， 从 而 用 来 


判断 哪个 元 素 变化 以 重新 泻 染 用 的 。 


8.2.3 React 的 props 和 state 


React 为 构建 UI 同时 提供 了 props 和 state 用 于 数据 的 传递 .props 和 state 都 可 以 用 来 表示 
组 件 的 状态 , props 是 作为 父 组 件 传递 给 子 组 件 的 数据 , 所 以 这 就 可 以 形成 一 个 数据 流 , 而 state 
是 作为 组 件 内 部 使 用 的 数据 或 者 状态 。 下 面 通 过 实例 说 明 这 两 者 的 区 别 。 

在 src 目录 下 新 建 一 个 名 为 NameListjs 的 文件 ， 作 为 Appjjs 组 件 的 子 组 件 ， 写 入 以 下 内 容 : 


/*3B| À React*/ 


import React, {Component} from 'react'; 


/* 构 建 类 */ 
class NameList extends Component ( 
/ * KNE pR 28 / 
constructor) 
super (); 
/* 定 义 初始 化 的 state*/ 
this.state = (show: true) 
} 
del = ()=>{ 
this.setState ((show: false}) 
) 
/* 定 义 render 方法 */ 
render() { 
/* 定 义 样式 */ 
const style = { 
qisplay:'imlime-biock"; 
widen: TOODA 
padarnrgRIght: 120px i7 
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A 


PIF BuUMm4E 


同时 将 Appjjs 修改 为 以 下 代码 : 
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export default App; 


在 这 段 代 码 中 , 子 组 件 的 username 和 age 都 是 props 数据 的 一 部 分 ， 而 这 些 数 据 都 是 由 父 


组 件 传递 过 来 的 ， 这 些 数据 是 子 组 件 的 初始 化 数据 ， 不 能 修改 。state 数据 是 由 子 组 件 自己 来 
维护 的 ， 同 时 子 组 件 可 以 修改 state 来 改变 组 件 目 身 的 状态 ， 所 以 说 state 是 组 件 私有 的 数据 。 


面 ， 


f. 


利用 create-react-app 的 npm start 命令 启动 应 用 后 , 在 浏览 器 中 可 以 看 到 如 图 8.9 所 示 的 页 
单 击 按钮 子 组 件 将 在 页 面 中 消失 。 


student 12 ae 
89 组 件 props 状态 和 state 状态 的 区 别 


利用 上 一 节 中 提 到 的 map 方法 可 以 很 轻松 地 复 用 这 个 组 件 ， 一 个 简单 的 列表 就 这 样 生 成 
将 Appjjs 文件 的 代码 修改 如 下 : 


lA Beact*/ 

meme REACE rA geomeoneneel rom CEACE; 
/* 引 入 NameList 类 */ 

import NameList from './NameList'; 

/* 引 入 样式 文件 */ 


import '"./App-css'; 


/* 构 建 类 */ 
class App extends Component { 
/* 定 义 render 方法 */ 
render() { 
/* 定 义 数据 */ 
Cor s LEI 
{username: 'java', age:'20'], 
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(username: 'javascript', age:'20'}, 
{username: 'php', age:'20'}, 


(username: 'python', age:'23']), 


{username: 'css', age:'12'}, 
(username: 'ruby', age:'10'}, 
]; 
return ( 


<div className="App"> 
[ 
store.map((item, i )=> { 
return (<NameList username={item.username} key={i}/>) 
}) 
} 
< dio 
Jz 


} 
} 


/* 导 出 类 */ 


export default App; 


这 样 在 浏览 器 中 就 可 以 看 到 一 个 简单 的 列表 ， 如 图 8.10 所 示 。 


java 


javascript 


图 8.10 简单 的 列表 


因为 props 是 由 父 组 件 传递 给 予 组 件 的 ， 所 以 props 的 改变 只 能 寄 和 希望 于 父 组 件 传递 新 的 


props。 而 state 是 组 件 自己 负责 维护 和 更 新 的 ， 因 此 React 提供 了 setState0 方 法 来 更 新 组 
件 的 state。 需 要 注意 的 是 这 个 方法 是 异步 的 。 


8.2.4 React 的 组 件 生命 周期 


React 组 件 的 state 或 者 props 发 生 改 变 后 会 导致 这 个 组 件 重 新 进行 泻 染 ， 此 时 DOM 也 会 
有 相应 的 变化 。 其 中 ， 只 有 Render 方法 是 上 文 提 到 的 ， 就 是 DOM 泻 染 时 的 方法 。 然 而 ， 只 
有 这 个 方法 是 不 够 的 , 因为 在 实际 开发 中 , 开发 者 往往 需要 在 泻 染 前 或 者 泻 染 后 去 做 一 些 额 外 
的 事情 ， 比 如 数据 的 请 求 、state 的 改变 等 。 因 此 ， 开 发 者 需要 对 组 件 的 各 个 阶段 进行 控制 ， 
这 样 就 可 以 足够 高 效 地 进行 开发 了 。 为 此 ，React 的 团队 提出 了 组 件 生命 周期 的 概念 。 

对 于 一 个 基本 的 React 组 件 ， 可 以 将 每 个 React 组 件 的 生命 周期 分 为 初始 化 、 挂 载 、 更 新 、 
EE 4 个 阶段 。React 为 这 4 个 阶段 提供 了 不 同 的 方法 ， 以 便 开 发 者 有 足够 的 控制 权 对 组 件 进 
行 控制 。 

React 的 组 件 生命 周期 可 以 用 图 8.11 来 表示 。 
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componentDidUpdate 


render 
getDefaultProps 


i mponentWillUnmoun 
componentWillUpdate componentWillUnmount 


qetlnitialState 

| 

| 

| componentWillMount shouldComponentUpdate i 结束 
| 

| 

render | 

| 

i | 

.componentDidMount ] componentWillReceiveProps | 

| 


图 8.11 组 件 生命 周期 


© 组 件 初 始 化 阶段 的 方法 有 getDefaultProps()、getInitialState()。 

@ 组 件 挂 载 阶段 的 方法 有 componentWillMount()、render()、componentDidMount()。 

@ 组 件 更 新 阶段 的 方法 有 shouComponentUpdate()、componentWillUpdate、render()、 
componentDidUpdate(). component WillReceiveProps(). 

© 组件 孝 载 的 方法 有 componentWillUnmount()。 


在 组 件 挂 载 阶段 并 不 会 调用 组 件 更 新 阶段 的 方法 ,也 就 是 说 在 初次 泻 染 过 程 中 , 更 新 阶段 


的 方法 是 不 可 用 的 ， 因 此 开发 者 不 应 该 将 初次 泻 染 使 用 的 方法 在 更 新 阶段 来 使 用 , 这 是 非 
常 不 明智 的 做 法 。 


同时 ，shouldComponentUpdate0) 方 法 应 该 返回 一 个 布尔 值 ， 如 果 人 返回 值 为 tue， 束 继续 更 
新 这 个 组 件 ; 相反 ， 如 果 返 回 值 为 false ， 将 不 更 新 这 个 组 件 。 也 就 是 说 ， 此 时 
componentWillUpdate()、render()、componentDidUpdate() 方 法 是 不 会 被 调用 的 。 

为 了 更 好 地 理解 组 件 生命 周期 的 概念 ， 利 用 一 段 代码 或 许 更 好 说 明 。 将 App.jjs 文件 内 容 
修改 如 下 : 
/* 引 入 React*/ 


import React, { Component } from 'react'; 


/* 引 入 样式 文件 */ 


I s App css"; 


/* 构 建 类 */ 
class App extends Component í 


CODSETUCEOT I) E1 


super () ; 
/* 定 义 初始 化 state*/ 
this.state = {name:1234} 
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gigo 
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A8 Hmi 


启动 这 个 应 用 后 ， 打 开 浏览 器 的 控制 台 ， 可 以 看 到 如 图 8.12 所 示 的 页 面 。 
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willMount 


render 


didmount 


图 8.12 ”组件 生命 周期 


这 与 预想 中 的 一 样 ， 处 于 组 件 更 新 阶段 的 方法 都 没有 被 调用 。 单 击 按钮 后 ， 组 件 的 state 
改变 了 ,， 因 此 会 造成 这 个 组 件 的 重新 泻 染 ， 此 时 更 新 阶段 的 方法 的 执行 顺序 和 预期 一 致 ， 如 图 
8.13 所 示 。 

willMount 
render 
didmount 
shouldupdate 


willupdate 


render 


didupdate 


图 8.13 组件 生命 周期 
如 果 将 处 于 更 新 阶段 的 shouldComponentUpdateO 的 返回 值 修改 为 false， 可 以 看 到 组 件 并 
没有 更 新 ， 处 于 这 个 方法 后 面 的 方法 自然 就 没有 被 调用 了 。 
作为 开发 者 ， 需 要 注意 的 是 这 些 处 于 生命 周期 的 函数 为 开发 者 更 好 地 控制 组 件 提供 了 可 
能 ， 同 时 也 应 该 善 用 这 些 方法 ， 因 为 对 这 些 方法 使 用 不 当 很 可 能 会 造成 React 应 用 的 性 能 
问题 。 


O.D 实战 一 图 书信 息 统 计 


本 节 将 利用 本 章 所 介绍 的 知识 实现 一 个 简单 的 React 实例 : 创建 一 个 简单 的 信息 统计 展示 
页 面 。 这 里 将 利用 笔者 个 人 作品 的 API 展示 一 个 简单 的 图 书 系统 信息 统计 页 面 。 这 个 页 面 展 
示 统 计 信息 ， 同 时 实现 信息 统计 条 件 的 切换 。 


8.3.1 生成 基本 的 目录 结构 


这 里 使 用 脚手架 工具 create-react-app 进行 开发 。 使 用 create-react-app 脚手架 之 前 需要 使 用 
NPM 进行 安装 : 
npm install create-react-app -g 


安装 脚手架 工具 之 后 就 可 以 使 用 create-react-app 来 生成 项 目 目录 结构 了 。create-react-app 
命令 如 下 : 
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create-react-app book 


等 竺 一 段 时 间 后 就 可 以 看 到 生成 的 项 目 目录 结构 了 。 
在 生成 的 目录 结构 下 的 src 文件 夹 下 创建 component, container 和 utils 文件 夹 。 


8.3.2 ”基本 的 结构 开发 


一 个 结构 完整 的 网 站 一 般 包 括 header, banner, nav, footer 等 部 分 。 为 了 页 面 的 完整 ， 这 
些 结构 在 这 里 依旧 需要 。 在 container 文件 夹 下 分 别 创建 AsideContainer.js、BannerContainer.js、 
FooterContainer.js、HeaderContainer.js、MainContainer.js 文件 ， 如 图 8.14 所 示 。 


AsideContainer.js JetBrains WebSt... 
BannerContainer.js JetBrains WebSt... 


FooterContainer.js JetBrains WebSt... 
HeaderContainer.js JetBrains WebSt... 
MainContainer.js JetBrains WebSt... 


图 8.14 项 目 基本 目录 结构 
在 HeaderContainer.js 文件 中 写 入 以 下 内 容 : 
/* 引 入 React */ 


import React from "react"; 


/* 定 义 头 部 组 件 */ 
const HeaderContainer = (props) => { 
return ( 
<header className="header"> 
Header 


he 
l: 


/* 导 出 头 部 组 件 */ 


export default HeaderContainer; 


同 理 ， 在 BannerContainer.js 文件 夹 中 写 入 以 下 内 容 作 为 标识 : 
/* 引 入 React */ 


import React from ‘react; 


/* 定 义 Banner 组 件 */ 
const BannerContainer = (props) => { 
Pen 
sect ron cloassName bannere> 


banner 
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< SECEnNOT> 
) 
}; 


/* 导 出 Banner 组 件 */ 


export default BannerContainer; 


其 他 几 个 组 件 也 一 样 。 其 中 ，MainContainer.js 文件 将 作为 开发 的 主要 文件 。 在 
MainContainer.js 文件 中 写 入 以 下 内 容 : 


/*38| À. React */ 
Importi Reactofrom ence, 


/* 引 入 主体 右 部 部 分 */ 


import MainRight from '../component/MainRight'; 


/* 定 义 主体 部 分 */ 
const MainContainer — (Props) > f 
return ( 
<section className="main-right"> 
maincontainer 
</section> 
) 
}; 


/* 导 出 主体 组 件 */ 


export default MainContainer; 


在 components 文件 夹 中 创建 BarEchartjs、Echartjs、MainRigth.js、PieEchart.js 文件 作为 
主要 开发 的 组 件 文件 。 在 utils 文件 夹 中 创建 ajax.js 和 htime.js 文件 ， 分 别 用 来 作为 处 理 ajax 
请 求 和 处 理 时 间 的 函数 。 在 ajax.js 文件 中 写 入 以 下 内 容 : 

/* 定 义 ajax 方法 */ 


const ajax = function (method, url, cb) { 
let xhr = new XMLHttpRequest () ; 
xhr.open (method, url, Lrue); 


xhr.send(); 


xhr.onreadystatechange = function() Í 
if (x<hr .readyState === 4) { 
TE((x=hr`statcus >= 200 g& xhr status < 300) || xhri`š`uscacus — 304) 1 
/* 处 理 方法 */ 


cb (xhr.responseText); 
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/* 导 出 ajax 方法 */ 


export default ajax; 
在 htime.js 文件 中 写 入 以 下 内 容 : 
/* 定 义 htime 方法 */ 


Const htime = ( 
getDiEE: ErnctTor(mium) í 
let time; 
T Ë (um) í 
time = new Date (new Date () .getTime() — num*24*60*60*1000); 
}else{ 
time = new Date () ; 


) 


return this.parseTime (time); 
]; 
parseTime: function(time) ( 
let year = time.getFullYear(); 
let month = time.getMonth() + 1 > 9 ? time.getMonth() + 1 : 'O' + (time.getMonth() 
+ 1) > 
let day = time.getDay() > 9 ? time.getDay(): '0' + time.getDay () ; 
rassaa eoe rT GE 
) 
}; 


/* 导 出 ajax 方法 */ 


export default htime; 


833 ”信息 图 表 的 开发 


为 了 简化 开发 、 提 高 开发 效率 ， 这 里 将 使 用 echart 图 表 库 ，echart 并 不 能 直接 用 在 React 
项 目 中 ， 对 应 的 有 一 个 rc-echarts 库 。 使 用 NPM 安装 这 个 库 之 后 承 可 以 像 使 用 echart 一 样 使 
用 这 个 库 了 。 


npm install rc-echarts 一 -SaVe 


在 上 一 小 节 中 提 到 components 文件 夹 中 的 几 个 文件 。 其 中 ，MainRight.js 是 其 他 组 件 的 入 
口 组 件 ， 因 此 开发 也 是 从 这 个 组 件 开始 的 ， 在 这 个 文件 中 写 入 以 下 内 容 : 


/* 引 入 React*/ 

import React from 'react'; 

/*38| A. ajaz*/ 

import ajax from "../uūutils/ajax'"; 


/* 引 入 饼 图 */ 
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这 里 需要 说 明 的 是 ， 需 要 将 ajax 请 求 置 于 componentDidMount 中 ， 同 时 BarEchart.js 和 
PieEchart.js 分 别 为 柱状 图 和 饼 状 图 的 组 件 ， 只 需要 按照 echart 的 配置 即 可 。 以 BarEchart.js 为 
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} ， 
nameGap: 15 
} 
}; 
const barSeries = { 
name:' 借 阅 量 '， 
Lypesrbar"; 
data: propsedataseoumntell aans 
itemStyle: { 
normal: f 
color: 'flc95ea';, 
barBorderRadius: [5, 5; 0; 
J; 
emphasis: { 
color: 'FfOA45e9d";, 
) 
]; 
barGap: '50%' 
l: 


return ( 
<Charte 1- paroOrtromns i> 


0] 


<Chart.Bar {...barSeries}/> 


< Chart> 


/* 导 出 条 形 图 组 件 */ 


export default BarEcharts; 


稍微 添加 一 些 样 式 即 可 实现 漂亮 且 简 单 的 图 表 类 型 切换 和 时 间 切 换 的 功能 ， 如 图 8.15 和 


图 8.16 所 示 。 


Een 条 形 图 | 


个 人 借阅 量 统计 


1 (1.28%) 
(3.85%) — 


(897%) — 


(15.38%) 一 


[object Object] 
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图 8.15 


项 目 饼 状 图 


[70.51%) 
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个 人 借阅 量 统计 
Saa 


图 8.16 项 目 条 形 图 


S.A 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


1. jQuery 主要 解决 了 哪些 问题 ? 
2. React 的 生命 周期 概念 有 哪些 ? 
3. 什么 是 JSX， 使 用 JSX 需要 注意 哪些 问题 ? 


171 


s 9 = 
4Node.js 的 框架 


£" 67 
I ISU > 


随 着 Node.js 的 快速 发 展 和 普及 ， 基 于 Node. js 的 框架 也 如 雨后春笋 般 涌 现 出 来 。 其 中 有 
很 多 Node.js 框 民 ， 可 以 帮助 你 快速 构建 实时 的 病 到 问 网 络 应 用 ， 并 且 无 须 任 何其 他 第 三 方 
Web 服务 需 、 应 用 服务 器 等 工具 和 技术 。 本 章 对 Node.js 的 主流 框架 进行 整体 介绍 ， 并 对 现在 
应 用 广泛 的 Express 和 Meteor 等 框架 进行 详细 的 分 析 和 比较 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


Node.js 主流 框架 的 分 类 和 特点 。 
Express 框架 介绍 。 

Meteor 框架 介绍 。 

其 他 一 些 流行 的 Node.js 框架 介绍 。 
框架 的 选择 和 注意 事项 。 


Node.js 框架 整体 介绍 


Node.js 得 益 于 JavaScript 的 广泛 普及 在 短 时 间 内 飞速 发 展 ， 让 前 痛 开 发 程序 员 仅仅 使 用 
JavaScript 就 可 以 建立 大 规模 、 实 时 性 、 可 扩展 的 移动 和 Web 应 用 程序 。 随 着 节点 生态 系统 的 
增长 ， 基 于 Node.js 的 框架 也 开始 稳步 发 展 。 对 于 一 个 中 小 型 的 开发 团队 来 说 ， 选 择 一 个 合适 
的 框 染 可 以 加 快 程序 的 开发 ， 使 得 应 用 更 加 健壮 并 减少 出 错 的 概率 。 

Node.js 的 分 类 有 很 多 方式 。 依 据 Node Frameworks 网 站 (http://nodeframework.com/〉 的 
PRYE, Node.js 的 框架 基本 可 以 分 为 四 大 类 : MVC 框架 、 全 栈 框架 、REST API 框架 以 及 其 他 
框架 。 目 前 主流 的 Node.js 框架 为 MVC 框 染 和 全 栈 框 染 。 下 面 将 分 别 介绍 这 几 大 类 框架 的 具 
体 特 点 和 每 种 类别 有 哪些 优秀 的 成 员 。 


9.1.1 MVC 框 染 


MVC 框架 是 从 传统 的 软件 开发 演进 而 来 的 ， 之 前 的 软件 开发 都 是 使 用 MVC IN. ii 
是 模型 -视图 -控制 器 (Model-View-Controller) 。 当 MVC 诞生 的 时 候 ，Web 服务 还 不 存在 ， 
当时 的 软件 架构 主要 是 客户 端 在 原始 网 络 中 与 单一 数据 库 进 行 会 话 。 由 于 MVC 历史 久远 ， 影 
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啊 力 也 很 大 ， 因 此 一 直 都 有 很 多 追随 者 。 

Node.js 官方 推荐 的 Express 框架 就 属于 MVC 框架 的 一 种 。 在 Node.js 的 MVC 框架 中 还 
存在 两 个 小 的 分 支 ， 分 别 为 Sinatra-like 和 Rails-like。Sinatra 和 Rails 都 是 Ruby 语言 的 Web 
框架 ， 后 者 的 影响 力 更 大 、 更 为 知名 。 

Sinatra-like 框架 高 度 可 配置 ， 注 重 开发 自由 度 ， 代 表 性 的 Node.js Web HERA: 


© Express (官方 网 址 为 http:Wexpressjs.com/ ) , Node.js 官方 推荐 。 
© Hapi (官方 网 址 为 http:/hapijs.comy/ ) 。 

© Koajs (官方 网 址 为 http:/koajs.com ) 。 

© Flatiron ( 官方 网 址 为 http:Wflatironjs.org/ ) 。 

@ Totaljs (官方 网 址 为 http://www.totaljs.com/ ) 。 

© Locomotive (官方 网 址 为 http://locomotivejs.org/ ) 。 

图 9 


.1 是 上 述 几 个 框 染 的 对 比 。 
Metric Express.js Koa.js Hapi.js 
Github Stars 16,158 4,846 3,283 
Contributors 163 49 95 
Packages that depend on: 3,828 99 102 
StackOverflow Questions 11,419 72 82 
图 9.1 框架 对 比 


Rails 框架 体现 为 不 重复 自己 和 约定 优 于 配置 ， 以 及 严格 遵循 MVC 结构 开发 ， 代 表 性 的 
HERA: 

@ Sailsjs (官方 网 址 为 http:Wsailsjs.org/ ) 。 

© Geddy (官方 网 址 为 http://geddyjs.org/) 。 

© CompoundJS (官方 网 址 为 http://compoundjs.com/ ) 。 

这 两 种 框架 无 所 谓 谁 优 谁 务 ， 全 和 赁 使 用 者 的 偏好 。 从 目前 的 使 用 情况 来 看 ，Sinatra-like 
的 Express 是 最 受 欢 迎 的 Node.js 框架 ， 也 是 Node.js 官方 推荐 的 唯一 框架 。 


9.1.2 EIER 

全 栈 框架 (Full-Stack Frameworks) 的 官方 解释 是 : XÆ Node.js 真正 的 闪光 点 ， 拥 有 大 量 
的 脚手架 、 模板 引擎 和 稳定 持续 的 开发 库 资 源 , 能 够 让 你 在 短 时 间 内 迅速 构建 一 个 实时 的 可 扩 
展 的 Web 应 用 程序 。 全 栈 框 染 也 是 Node.js 框 染 家 族 中 成 员 最 多 的 一 类 框 染 ,大 名 鼎鼎 的 Meteor 
和 MEAN 都 属于 全 栈 框架 ,可 以 让 你 轻松 构建 一 个 大 型 的 Web 应 用 ， 而 不 用 在 诸多 细节 上 当 
费 大 量 的 时 间 。 全 栈 框 染 的 部 分 成 员 如 下 : 


© AllcountJS (官方 网 址 为 http://allcountjs.com/ ) 。 
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Derby ( 官方 网 址 为 http://derbyjs.com/ ) 。 

Feathers ( 官方 网 址 为 http://feathersjs.com/ ) 。 

SocketStream ( 官方 网 址 为 http://socketstream.org/ ) 。 
MEANJjs (官方 网 址 为 http://meanjs.org/ ) 。 

MEAN.io (官方 网 址 为 http://mean.io/ ) 。 

Meteor ( 官方 网 址 为 http://meteor.com/ ) 。 

Meatier ( 官方 网 址 为 https://github.com/mattkrick/meatier ) 。 
TWEE.IO ( 官方 网 址 为 http://twee.io/ ) 。 

Mojito ( 官方 网 址 为 http://developer.yahoo.com/cocktails/mojito/ ) 。 
Seeds.js ( 官方 网 址 为 http://seedsjs.com/ ) 。 

SANE ( 官方 网 址 为 http://sanestack.com/ ) 。 


REST API 框架 


REST 框架 起 源 于 2000 年 左右 ， 是 由 著名 的 HTTP 协议 设计 者 之 一 Fielding 提出 来 的 。 
REST 框架 也 是 目前 流行 的 一 种 互联 网 软件 架构 。 其 中 ，REST 分 别 代 表 资 源 (Resources) 、 
表现 层 (Representation) 和 状态 转化 (State Transfer) 。 它 结构 清晰 、 符 合 标 准 、 另 于 理解 、 
扩展 方便 ， 所 以 得 到 越 来 越 多 的 网 站 采用 ， 并 且 非 常 适合 需要 在 客户 端 表现 丰富 的 应 用 程序 。 
Node.js 家 族 中 属于 REST 类 的 框架 也 不 少 ， 比 较 出 名 的 框架 如 下 : 


9.1.4 


actionHero.js ( 官方 网 址 为 http://www.actionherojs.com/ ) 。 

Frisby ( 官方 网 址 为 http://frisbyjs.com/ ) 。 

restling ( 官方 网 址 为 https://github.com/lucasfeliciano/restling ) 。 

restify ( 官方 网 址 为 http://restify.com/ ) 。 

restmvc ( 官方 网 址 为 https://github.com/keithnlarsen/restmvce.js ) 。 

LoopBack ( 官方 网 址 为 https://strongloop.com/node-js/loopback-framework/ ) 。 
facet ( 官方 网 址 为 http://facet.github.io/platform/ ) 。 

Raddish ( 官方 网 址 为 http:/Wgetraddish.comy/ ) 。 


其 他 框 染 


除了 以 上 提 到 的 三 大 类 框 染 外 , 还 有 一 些 框 染 无 法 很 好 地 进行 分 类 , 我 们 一 般 把 它们 归 为 
单独 的 一 个 类 别 ， 主 要 包含 中 间 件 、 开 发 库 和 静态 网 站 的 生成 器 等 。 其 中 ， 主 要 代表 有 : 


174 


Connect ( 官方 网 址 为 https://github.com/senchalabs/connect#readme ) 。 
Kraken ( 官方 网 址 为 http://krakenjs.com/ ) 。 

ewdGateway2 ( 官方 网 址 为 https://github.com/robtweed/ewdGateway2 ) 。 
Wintersmith ( 官方 网 址 为 https://github.com/jnordberg/wintersmith ) 。 
docpad (http://docpad.org/ ) 。 
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© Blacksmith (http://blacksmith.jit.su/ ) 。 
@ romulus (https://github.com/felixge/node-romulus ) 。 


除了 按照 上 面 的 方式 分 类 之 外 ，Node.js 的 框架 也 经 常 被 分 为 实时 框架 (Real-Time 
Framework) 和 非 实 时 框架 。 

实时 框架 是 指 包含 WebSocket 的 双 回 通信 功能 ， 能 够 在 服务 端 和 客户 端 做 到 实时 通信 的 
框架 。 非 实时 框架 无 法 做 到 实时 通信 。 

服务 端 和 客户 端 上 自由 通信 的 需求 一 直 都 在 , 由 于 HTTP 协议 本 和 喘 的 局 限 性 而 众生 了 Comet 
等 变通 的 方法 ,即使 这 样 也 离 实 时 相距 其 远 。 当 Node.js 兴 起 后 , 另 一 个 HIML 5 技术 WebSocket 
渐渐 成 熟 。 人 们 突然 发 现 ， 实 时 通信 一 下 子 方便 简单 了 。 于 是 WebSocket RE Node.js 中 得 
到 大 量 的 应 用 ， 其 中 最 为 知名 的 模块 是 socket.io,， 而 各 种 全 栈 框架 也 纷纷 加 入 实时 特性 来 应 对 
更 广阔 的 开发 需求 。 目 前 有 代表 性 的 实时 框架 有 Meteor、MEAN.io、Derby、SocketStream。 

目前 在 互联 网 上 实时 通信 的 应 用 场景 并 不 是 很 多 ， 其 中 大 多 集中 于 聊天 室 、to-do、 实 时 
图 表 、 在 线 游戏 等 领域 。 其 他 领域 使 用 实时 特性 不 但 没 必 要 ， 而 且 是 对 服务 器 资源 的 浪费 。 因 
此 ， 目 前 是 否 要 采用 实时 框架 要 视 具体 的 项 目 而 定 。 


Ë 元 | 由 于 Node.js 还 很 年 轻 ， 目 前 并 没有 WordPress 这 样 比较 完善 的 程序 ， 因 此 如 果 在 Node.js 
| 开发 中 想 快速 开发 出 自己 想 要 的 应 用 ， 框 架 是 必然 的 选择 。 如 果 是 某 些 特定 类 型 的 应 用 ， 
可 以 尝试 一 些 开源 的 程序 ， 比 如 要 用 Node.js 做 博客 ， 有 Hexo、Ghost 等 。 这 一 框架 的 完 


善 性 使 其 被 称 为 LAMP (Linux+Apache+MySQL+PHP) 的 接班 人 。 


9.2 Express 框架 介绍 


Express 框架 是 Node.js 基金 会 的 一 个 项 目 ， 官 方 网 址 为 http:Wexpressjs.com 《中文 网 站 为 
http://expressjs.com/zh-cn/) 。 它 提供 了 对 Node.jjs 原生 API 比较 好 的 封装 ， 从 而 使 开发 者 更 加 
容易 使 用 Node.js， 并 用 来 开发 强壮 的 Web、 移 动 应 用 ， 以 及 API 的 一 些 其 他 功能 。 开 发 人 员 
还 能 够 方便 地 为 它 开发 插件 和 扩展 ， 从 而 增加 Express 的 能 

通过 使 用 Node Express， 可 以 使 用 更 少 的 代码 来 实现 功能 。 至 少 通过 使 用 Node Express 
可 以 实现 中 间 件 来 吗 应 HTTP 请 求 , 可 以 定义 路 由 表 来 定义 对 不 同 请 求 的 啊 应 函数 , 还 可 以 使 
用 模板 引擎 来 输出 HTML 页 面 。 

Express.js 无 疑 是 当前 Node.js 中 最 流行 的 Web 应 用 程序 框架 ， 甚至 Sailsjjs 这 样 的 流行 框 
架 也 是 基于 Express.js 的 。 
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e 元 Express 没有 数据 库 的 概念 ， 留 给 第 三 方 Node 块 实现 ， 因 此 几乎 可 以 接 入 任何 数据 库 。 


Express 的 API A 2.x 版本、3.x 版 本 和 4.x 有 版本。 其 中 ，2.x 版 本 和 3.x 版 本 已 经 基本 不 用 
了 ， 建 议 读 者 使 用 API 4.x 版 本 ， 其 在 线 文档 地 址 为 http://expressjs.com/zh-cn/4x/api.html。 下 
面 列 出 一 些 Express 提供 的 基本 功能 。 

@ 可 以 和 任何 第 三 方 数据 库 进行 通信 .。 

@ 可 以 使 用 任何 用 户 认证 方式 。 

© 可 以 使 用 任何 符合 Express 接口 定义 的 模板 引擎 。 

@ 可 以 按照 需要 定义 工程 目录 。 


对 于 一 个 Node.js 开发 新 手 来 说 ，Express 还 提供 了 如 下 好 处 : 


© Express 的 学 习 曲 线 并 不 陡峭 ， 可 以 很 快 上 手 .。 
@ Express 有 非常 庞大 的 社区 和 组 织 恨 好 的 文档 。 新 手 可 以 很 容易 得 到 所 需要 的 一 切 。 


Express 丰富 的 资源 是 其 他 框架 无 法 比拟 的 。 这 也 是 Express 框架 的 一 大 优势 。 下 面 列举 
Express 社区 的 常用 资源 。 


@ 邮件 发 送 列表 : £ Google Group 中 加 入 超过 2000 名 Express 用 户 的 行列 ， 浏 览 超 过 
5000 个 讨论 。 

© Gitter: strongloop/express 聊天 室 是 对 Express 相关 的 日 常 讨 论 感 兴趣 的 开发 人 员 的 
理想 去 处 。 

© IRC 频道 : 数 百名 开发 人 员 每 天 参与 讨论 freenode 的 #express 话题 。 如 果 存 在 有 关 框 
架 的 问题 ， 可 以 马上 加 入 讨论 以 获得 快速 反馈 。 

@ 示例 : 可 以 查看 存储 库 中 数 十 个 Express 应 用 程序 示例 。 这些 示 例 涵盖 从 API 设计 和 
认证 到 模板 引擎 集成 的 一 切 内 容 。 


在 Express 中 ，404 响应 不 是 错误 的 结果 ， 所 以 错误 处 理 程序 中 间 件 不 会 将 其 捕获 。 此 行 
为 是 因为 404 响应 只 是 表明 缺少 要 执行 的 其 他 工作 。 换 言 之 ，Express 执行 了 所 有 中 间 件 
函数 和 路 由 ， 且 发 现 它 们 都 没有 响应 。 我 们 要 做 的 只 是 在 堆栈 的 最 底部 〈 在 其 他 所 有 函数 
Z F) 添加 一 个 中 间 件 函数 来 处 理 404 响应 : 


app.use (function (req, res, next) [Í 
res.status (404) .send('Sorry cant find that!'); 
J); 
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Meteor 框架 介绍 


Meteor 框架 是 Node.js 最 出 色 的 全 栈 框架 ,可 以 说 是 除了 Express 之 外 最 火 的 Node.jjs 框 架 。 
Meteor 的 项 目 在 GitHub 上 有 28000 多 的 赞 ， 拥 有 大 量 的 目 定 义 包 、 庞 大 的 社区 文 持 、 非 党 好 
的 教程 和 文档 ， 在 国内 也 有 大 量 的 粉丝 和 拥护 者 。 在 全 栈 框 架 中 ，Meteor 至 无 颖 问 是 王者 ， 
我 们 可 以 用 它 构 建 纯 JavaScript 的 实时 Web 和 手机 应 用 。 

无 论 是 服务 器 端的 数据 库 访问 、 商 业 逻 辑 实现 还 是 客户 端的 展示 ， 在 Meteor 中 所 有 的 流 
程 都 可 以 进行 无 颖 连接 。 整 个 框架 使 用 统一 的 API, Meteor API 同时 适用 于 客户 端 和 服务 器 端 。 

Meteor 使 用 的 DDP 协议 可 以 让 我 们 在 后 端 连接 简单 的 数据 库 服 务 、 企 业 数 据 仓库 ， 甚 至 
是 IOT 传感器 。Meteor 市 有 目 己 默认 的 栈 ， 又 有 足够 的 灵活 性 ， 可 以 让 我 们 选择 自己 的 技术 
方案 。 如 果 不 需 要 尝试 其 他 的 框架 或 者 没有 其 他 的 条 件 限制 , 可 以 直接 使 用 默认 配置 进行 快速 
的 应 用 开发 。 

Meteor 拥有 专业 化 的 开发 团队 、 顶 级 风 投 的 大 量 资 金 支 持 ， 时 刻 保持 业界 领先 。Meteor 
在 国内 也 有 专门 的 中 文 社区 和 很 多 中 文 视频 教程 ， 非 常 适合 初 学 者 自学 。 

下 面 是 Meteor 的 一 些 资 源 列 表 。 


© Meteor 官方 网 站 (https://www.meteor.com/ ) 。 

Meteor 官方 文档 ( http://docs.meteor.com/#/full/24 ) 。 

Meteor 相关 问题 ( http://stackoverflow.com/questions/tagged/meteor10 ) 。 

Meteor 中 文教 程 ( http://zh.discovermeteor.com/chapters/getting-started/62 ) 。 
Meteor 的 一 些 包 推荐 ( https://gentlenode.com/journal/meteor-22-the-best-meteor- 


packages-you-must-know-to-code-faster-than-ever/5241 ) 。 


© Meteor 中 文 社区 (http://www.meteorhub.org/ ) 。 


9.4.1 Saills.js 


Sails.js (Node.js MVC) HI Mike McNeil 创建 ， 在 MIT 协议 下 开源 ， 现 在 由 Treeline and 
balderdash 提供 支持 。Sails 作为 一 个 非常 稳固 的 Node js 框架 ,提供 了 建立 任何 规模 的 Web 应 
用 所 需要 的 所 有 功能 。 

Sails.js 在 底层 使 用 Express 框架 来 提供 对 http 请 求 的 处 理 ， 同 时 使 用 Socket.IO 框架 来 处 
FE WebSocket 请 求 。 作 为 一 个 前 端 应 用 开发 框架 ， 它 允许 开发 人 员 选 择 他 们 熟悉 的 技术 来 开 
发 应 用 。 

Sails.js 还 通过 waterline 框架 实现 了 ORM 功能 。 通 过 这 个 功能 ， 应 用 程序 在 不 进行 大 的 
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修改 的 前 提 下 ， 可 以 从 一 个 后 端 数 据 库 切换 到 另 一 个 后 端 数据 库 〈 也 可 以 是 一 个 NoSQL 数据 
库 ) 。 

Sais 特别 适合 用 来 开发 对 数据 的 实时 更 新 有 较 高 要 求 的 应 用 ， 比 如 多 人 棋 类 游戏 、 单 页 
Web 应 用 等 。 如 果 读 者 对 Ruby. Django 或 者 Zend 有 一 定 的 了 解 ， 就 非常 容易 理解 Sail 中 的 
概念 。 

简单 来 说 ，Sails .js 既 给 开发 者 提供 了 一 个 优秀 的 MVC 框架， 也 提供 了 一 定 的 灵活 性 ， 让 
开发 者 可 以 目 主 选择 前 端 开发 方式 和 后 端的 数据 库 。 


9.4.2 Derby.js 


Derby.js〈 全 栈 框架 〉 跟 它 的 直接 竞争 对 手 Meteor、Mean.io 和 Mojito 一样， 也 是 一 个 全 
栈 框架 。 它 运行 在 Node.js + Mongo + Redis 的 上 层 。Derby 的 主要 部 分 是 一 个 叫 作 Racer 的 数 
据 同 步 引 擎 。 它 能 够 让 数据 在 数据 库 、 服 务 嚣 和 浏览 器 之 间 的 同步 变 得 轻而易举 。 

Racer 的 确 能 够 让 基于 Derby 框架 的 应 用 运行 得 更 快 。 无 论 是 在 浏览 器 端 还 是 服务 器 亲 ， 
对 于 单 页 面 应 用 来 说 ， 它 都 是 一 个 完美 的 选择 方案 。Derby 经 常 被 用 来 和 业界 老大 Meteor 进 
行 比 较 ，Meteor 项 目 已 经 开发 了 一 段 时 间 ， 因 而 能 够 提供 更 多 的 开 箱 即 用 功能 ， 使 在 更 短 的 
时 间 内 开发 复杂 的 Web 应 用 变 得 更 加 容易 。 

Derby 更 适合 需要 更 快运 行 速度 的 应 用 ， 并 且 它 的 模块 化 方式 能 够 让 应 用 更 灵活 、 更 容易 
扩展 。Derby 最 近 的 发 展 有 些 缓慢 ， 但 它 并 没有 出 局 ， 仍 有 改写 Node.js 全 栈 框架 游戏 规则 的 
潜力 。 


9.4.3 Flatiron.js 


Flatiron.js (Node.js MVC 框架 ) 的 核心 思想 是 让 你 能 够 使 用 它 所 提供 的 组 件 以 及 一 些 第 三 
方 库 构 建 自己 的 全 栈 框架 。 然而 , 这 市 来 的 是 更 局 的 复杂 度 ， 并 有 可 能 会 被 使 用 错误 组 件 的 开 
发 者 搞 得 一 团 糟 。 

Flatiron 是 一 个 由 多 个 相互 独立 的 组 件 松散 地 组 建 起 来 的 全 栈 MVC 框架 。 它 支持 Director, 
这 是 一 个 从 头 到 脚 都 使 用 JavaScript 搭建 起 来 的 ， 并 不 需要 任何 依赖 项 的 URL 路 由 组 件 。 

通过 Plates 模板 引擎 ，Flatiron 能 够 文 持 模 板 语 言 ， 然 而 数据 管理 是 通过 JSON 实现 的 ， 
并 能 与 任何 一 种 数据 库 一 起 使 用 。Flatiron 现在 由 Nodejitsu 以 及 其 他 的 社区 成 员 进 行 维护 ， 并 
且 做 得 相当 不 错 ， 是 一 个 不 那么 流行 却 值得 一 看 的 框 染 。 


9.4.4 Hapi 


Hapi 是 为 数 不 多 的 不 依赖 于 Express 的 Node.js 框架 ， 现 在 甚至 已 经 完全 独立 于 Express 
了 。 在 最 近 一 段 时 间 , 很 多 开发 者 选择 Hapi, 而 非 Express, 这 使 得 Hapi 或 多 或 少 成 为 Express 
的 竞争 对 于 。 

Hapi 在 众多 Node.js 框架 中 并 非 一 个 老牌 选手 , 然而 它 却 成 功 地 在 这 当中 创造 了 目 己 的 一 
个 生态 圈 。Hapi 致力 于 完全 分 离 node HTTP 服务 器 、 路 由 以 及 业务 逻辑 ， 并 更 多 地 聚焦 于 如 
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何 尽 可 能 通过 配置 而 非 代码 来 控制 。 

Hapi 最 初 是 由 Eran Hammer 在 Walmart labs 的 团队 为 了 工作 需要 而 开发 的 。 其 后 便 很 快 
受到 欢迎 ， 现 在 已 经 在 MIT 许可 下 成 为 一 个 开源 的 框架 ， 能 够 免费 地 被 下 载 和 使 用 。 

迪士尼 、 雅 虎 、Pebble、beats 音乐 以 及 Walmart 这 样 的 公司 都 在 使 用 Hapi 作为 一 个 或 多 
个 项 目的 网 络 应 用 框架 。Hapi 的 影响 力 可 见 一 斑 。 


9.4.5 Mean.lO 


Mean 是 Mongo DB. Express, Angular 和 Node.js 捆绑 在 一 起 的 组 合 。 基 本 上 可 以 说 只 要 
有 Mean， 你 就 拥有 了 数据 库 层 、 服 务 器 端 和 网 页 前 端的 整套 工具 ， 足 以 开发 所 有 类 型 的 现代 
网 络 应 用 。 

Mean 是 一 个 完整 独立 的 包 ， 涵 凋 应 用 开发 的 所 有 方面 ， 尤 其 适合 那些 需要 快速 开始 开发 
的 人 。 它 内 置 多 种 技术 ， 而 且 在 联合 使 用 时 表现 非常 好 ， 可 以 用 于 创建 任意 大 小 和 复杂 度 的 应 
用 。 

使 用 Mean， 开 发 者 可 以 避免 经 历 混合 和 匹配 不 同 的 技术 栈 。 通 过 Mean 栈 可 以 减少 安装 
和 配置 MongoDB, Express, Angular 和 Node.js 需要 的 时 间 。Mean.io 的 另 一 个 巨大 好 处 是 所 
有 的 栈 都 使 用 JavaScript。 


PD Mean js £ Mean 的 一 个 分 支 , Mean js 已 经 成 为 一 个 独立 的 Node. js 框架 , 并 且 相 当 流 


行 。 


946 Mojito 


Mojito 由 Yahoo 开发 并 迅速 取得 成 功 ， 只 是 很 快 就 市 看 关于 框架 的 空前 成 功 坐 到 了 冷 板 
使， 就 像 Meteor 和 Mean stack 那样 。 

Mojito 同样 是 一 个 MVC 应 用 框架 ， 非 常 适合 创建 使 用 HIML 5, JavaScript 和 CSS 3 的 
高 性 能 网 络 和 手机 应 用 。Mojito 的 根本 目标 是 提供 一 个 框架 , 用 于 构建 标准 的 基于 路 平台 的 应 
用 ， 使 之 可 以 同时 运行 在 客户 端 和 服务 器 端 并 实现 高 性 能 。 


9.4.7 Socket Stream 


Socket Stream 是 一 个 专注 于 客户 端 和 服务 端 数 据 的 快速 同步 的 实时 框架 ， 致 力 于 前 后 端 
数据 的 实时 更 新 。 它 最 大 的 特点 是 不 严格 要 求 使 用 指定 的 客户 奖 技 术 ， 也 不 限定 数据 库 的 
ORM。 它 更 适合 做 单 页 Web 应 用 、 多 用 户 游 戏 、 聊 天 客户 端 、 网 络 应 用 、 交 易 平台 以 及 所 有 
需要 将 数据 从 服务 端 实时 推送 到 客户 端的 应 用 。 

服务 端 和 客户 端 使 用 JSON 来 传输 数据 ， 比 较 理想 的 是 使 用 WebSockets 在 服务 端 事 件 发 
生 时 目 动 将 数据 推送 到 客户 疹 。Socket Stream 由 Owen Barnes 创建 ， 现 由 Paul Jensen 和 其 团 
队 维 护 。 
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Socket Stream 获得 了 很 好 的 发 展 , 其 他 类 似 的 优秀 框架 还 有 totaljs、Geddy.JS、Locomotive、 
compound 和 Restify。 


94.8 Bearcat 


Bearcat 是 网 易 pomelo 项 目 团队 开发 的 一 个 基于 POJOs 进行 开发 的 应 用 层 框架 。Bearcat 
提供 了 一 个 轻 量 级 的 容器 来 编写 简单 、 可 维护 的 Node.js。Bearcat 提供 了 一 个 基础 的 底层 来 管 
理应 用 逻辑 对 象 , 使 开发 者 可 以 把 精力 放 在 应 用 层 的 逻辑 编写 上 。 核心 Beans 模块 提供 容器 的 
基础 部 分 ， 包 含 IoC 容器 和 依赖 注入 。BeanFactory 是 一 个 复杂 的 工厂 (factory) 模式 实现 。 
Bearcat 去 除了 手动 编写 单 例 ， 人 允许 实 际 程序 逻辑 从 配置 和 依赖 的 管理 中 解 厢 ， 网 址 为 
http://github.com/bearcat]js/bearcat。 


也 . 了 如 何 选择 适合 自己 的 框架 


当 开 发 应 用 程序 时 ， 需 要 选择 整合 各 种 工具 、 库 和 框架 到 应 用 程序 中 。 在 和 面 对 这 么 多 
Node.js 框架 的 时 候 ， 可 能 一 时 有 点 不 知 所 措 ， 尤 其 是 在 不 熟悉 它们 的 时 候 ， 并 且 这 些 框 六 和 
技术 每 天 都 在 不 断 地 更 新 。 

在 某 些 情况 下 ， 选 择 最 流行 和 广 受 好 评 的 工具 是 比较 容易 的 ， 只 需要 在 GitHub 得 看 一 下 
热度 承 能 了 解 。 然 而 不 总 是 这 样 。 在 很 多 时 候 ， 有 多 个 框架 同时 都 适合 基本 需求 ， 并 且 都 有 各 
目的 长 处 。 同 时 ， 开 发 者 还 要 考虑 和 旧 系 统 的 兼容 性 以 及 项 目 以 后 的 发 展 方 同等 因素 。 


9.5.1 选择 框架 时 的 考虑 事项 
选择 框架 的 时 候 一 般 需 要 考虑 以 下 几 点 : 


(1) 实用 性 。 与 项 目 需求 的 结合 度 是 否 充分 ， 例 如 当前 需要 的 是 UI 框架 ， 就 不 应 该 找 
网 络 方面 的 东西 , 反之 需要 一 个 图 片 加 载 内 存 优化 的 框架 , 也 不 可 能 去 找 一 个 多 线程 下 载 的 框 
R. 例如， 考虑 一 个 XML 解析 库 ， 它 应 该 可 以 创建 一 个 DOM， 然 后 返回 一 个 组 织 良 好 的 错 
误 列表 。 

(2) 羔 容 性 。 一 个 框架 可 能 使 用 的 技术 非常 新 闲 ， 但 是 它 是 否 会 与 其 他 正在 使 用 的 库 产 
生 不 兼容 呢 ? 这 种 冲突 在 JS 开发 中 经 常 发 生 。 例 如 ， 你 可 能 会 使 用 Prototype 作为 JS 框架 ， 
但 是 当 你 寻找 内 鹃 的 HTML 编辑 器 时 ， 需 要 检查 它们 是 否 与 现 有 的 Prototype 版 本 兼容 。 如 果 
想 继续 使 用 之 前 用 过 的 JavaScript 库 ， 就 需要 但 看 这 个 库 是 否 在 新 的 框架 能 够 兼容 。 

(3) 扩展 性 。 对 于 任何 解决 实际 问题 的 框 染 来 说 ,你 将 或 多 或 少 地 需要 定制 或 者 扩展 它 。 
在 Java 中 ,可 以 通过 接口 来 完成 。 我 们 回头 看 XML 解析 器 的 问题 ,可 以 通过 实现 特殊 的 接口 
并 提供 给 解析 器 来 创建 一 个 自 定 义 的 错误 处 理 。 这 种 类 型 的 定义 是 非常 直接 的 , 在 大 多 数 框架 
中 也 是 可 行 的 。 另 一 种 扩展 是 使 用 插件 。 虽 然 不 同 应 用 程序 定义 插件 的 方式 不 同 , 但 是 一 般 来 
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说 总 是 将 代码 “于 ”到 一 个 预先 定义 的 方法 中 。 例如， 一 些 内 舱 的 HMTL 编辑 器 允许 把 JS 代 
码 放 到 一 个 特定 的 目录 。 这 段 代码 必须 符合 某 些 规范 ， 就 像 实现 Java 接口 一 样 。 插 件 是 一 个 
有 趣 的 模型 ， 可 以 让 你 创建 原始 框架 所 不 具备 的 特性 。 这 种 方式 是 非常 强大 的 。 

(4) 成 熟 度 。 需 要 考虑 框架 的 代码 是 否 便于 商用 开发 、 技 术 是 否 相对 成 熟 、 是 否 能 够 长 
期 稳定 地 发 展 。 如 果 是 开源 的 框架 ,就 需要 考虑 所 使 用 的 开源 协议 对 商业 项 目 是 否 友 好 、 开 源 
协议 有 没有 感染 性 等 。 

(5) 资源 及 易 用 性 。 这 样 方便 上 手 ， 也 容易 在 团队 中 推广 使 用 。 好 的 框架 一 般 都 会 有 一 
个 比较 好 的 社区 文 持 , 出 了 问题 能 够 方便 地 找到 解决 方案 , 能 够 让 开发 者 持续 维护 并 及 时 解决 
Bug。 这 样 就 能 够 节省 团队 中 维护 框架 的 成 本 。 成 熟 的 框架 总 是 比 新 的 竞争 者 有 更 多 的 帮助 资 
源 。 社 区 论坛 、 邮 件 列 表 、 博 客 ， 甚 至 像 StackOverflow 这 样 的 站 点 都 提供 了 丰富 的 帮助 资讯 。 
要 知道 你 调查 的 框架 是 否 有 活动 的 社区 、 邮 件 列表 、StackOverflow 的 权威 回复 ， 能 够 回答 关 
于 框架 的 大 量 问 题 。 在 学 习 一 个 新 工具 的 过 程 中 ,寻找 帮助 和 样 例 代 码 总 是 极为 重要 的 。 看 博 
客 也 非常 有 帮助 ， 因 为 它 会 告诉 你 谁 在 谈论 这 个 框架 。 

(6) 可 定制 化 。 框 架 能 够 自己 进行 定制 和 修改 。 随 着 应 用 程序 开发 的 不 断 深入 ， 这 样 可 
以 满足 应 用 程序 更 加 复杂 的 要 求 ， 让 项 目 不 受 制 于 原 有 框架 的 局 限 性 ， 能 够 更 加 灵活 。 


952 选择 框架 的 建议 
下 面 针 对 各 种 不 同类 型 的 应 用 开发 给 出 一 些 框架 选择 的 建议 。 
(1) 简单 Web 开发 : 框架 选择 Express + EJS + Mongoose/MySQL 
通常 用 Node.js 做 Web 开发 ， 需 要 3 个 框架 配合 使 用 ， 束 像 Java 中 的 SSH, Express 是 轻 
量 灵活 的 Node.js Web 应 用 框架 。EJS 是 一 个 伐 入 的 JavaScript 模板 引擎 , 通过 编译 生成 HTML 
代码 .Mongoose 作为 MongoDB 的 对 象 模型 工具 , 通过 Mongoose 框架 可 以 进行 访问 MongoDB 
的 操作 。MySQL 是 连接 MySQL 数据 库 的 通信 API， 可 以 进行 访问 MySQL 的 操作 。 


(2) MRE OM) : 框架 选择 Express + socket.io 
socket.io 是 一 个 基于 Node.js 架构 体系 、 文 持 WebSocket 协议 、 用 于 实时 通信 的 软件 包 。 
socket.io 给 路 浏览 器 构建 实时 应 用 提供 了 完整 的 封装 ， 完 全 由 JavaScript 实现 。 


(3) EE: HEIE Cheerio/Request 
Cheerio 是 一 个 为 服务 器 特别 定制 的 快速 、 灵 活 、 封 装 jQuery 核心 功能 的 工具 包 。Cheerio 
包括 jQuery 核心 的 子 集 ， 从 jQuery 库 中 去 除了 所 有 DOM 不 一 致 性 和 浏览 器 不 兼容 的 部 分 ， 
揭示 了 它 真正 优雅 的 API. Cheerio 工作 在 一 个 非常 简单 、 一 致 的 DOM 模型 之 上 上， 解析 、 操 
作 、 浓 染 都 变 得 难以 置信 的 高 效 。 基 础 的 端 到 闯 的 基准 测试 显示 Cheerio 大 约 比 JSDOM 快 8 
f (8x) 。 


(4) 博客 系统 : 框架 选择 Hexo 
Hexo 是 一 个 简单 、 轻 量 、 基 于 Node 的 静态 博客 框架 ， 甚 至 可 以 媲美 WordPress。 通 过 
Hexo 可 以 快速 创建 自己 的 博客 , 仅 需 要 几 条 命令 就 可 以 完成 。 发 布 时 ，Hexo 既 可 以 部 署 在 目 
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己 的 Node 服务 器 上 面 ， 又 可 以 部 署 在 GitHub 上 面 。 基 于 GitHub 的 个 人 站 点 逐渐 流行 起 来 。 
对 于 个 人 用 户 来 说 ， 部 署 在 GitHub 上 好 处 颇 多 ， 不 仅 可 以 省 去 服务 器 的 成 本 ， 还 可 以 减少 各 
种 系统 运 维 的 麻烦 〈 系 统管 理 、 备 份 、 网 络 ) 。 


(5) 论坛 : 框架 选择 Node Club 
Node Club 是 用 Node.js 和 MongoDB 开发 的 新 型 社区 软件 ， 界 面 优雅 ， 功 能 丰 旦 ， 小 巧 迅 
速 ， 已 在 Node.js 中 文 技术 社区 CNode( 见 图 9.2) 得 到 应 用 。 我 们 完全 可 以 用 它 搭建 自己 的 
社区 。 


文件 (Fi RE SEV 历史 (5) #26) 工具 四 #ANH) = O x 


Ê CNode: Nodcj= 专 业 中 文 计 区 X | 十 


< C: | G> & htips://modejs.org Ë u @ | | Q S= lx € s mmm ë ee z > 


精华 $= PR 。 招聘 BPA CNode; Node js 专业 中 文 社区 


36/ [杭州 - 九 月 」 Node Party 线 下 技术 分 亨 Eaa pi 
TE aiiadockerikit, SAREAREN ARS? 2 oam 

Ue BS v8 内 存 分 配 浅 淡 B em 
= 你 试 过 不 用 i 营 代码 吗 ? S mem 
= 前 后 端 300 集 视频 教程 分 吉 (React，Nodejs) B :em 


Ë Ea Q s 人 本 
0/ 有 有 没有 好 的 react 学 习 源 码 可 看 的 哇 2 Jm ` L isisa da 


aS crontab 执 行 pm2 命 令 


RE CDN emren 


D= 足下 egg 的 热度 , BEHEART, 你 们 有 什么 想 说 的 
ao DZ Eggjs 视 频 教 程 -Eggjs 教 程 网 盟 分 享 希 吝 老 铁 门 能 喜欢 dont A sas 


有 没有 好 的 react 学 习 源 码 可 看 的 吐 


ü ë" °“ É w = É 
F O h N š Q 


园 EE ë ` 
Ë 际 
š 


六 关 于 vue js 的 一 些 总 结 
92 ”CNode 页 面 
(6) 控制 台 工 具 : 框架 选择 tty.js 
tty.js( 见 图 9.3) 是 一 个 文 持 在 浏览 器 中 运行 的 命令 行 窗 口 ,基于 Node.js 平 台 ,依赖 socket.io 
BE, 通过 WebSocket 与 Linux 系统 通信 。tty.js 的 特性 是 支持 多 Tab 窗口 模型 、 支 持 vim 语法 、 
支持 xterm 鼠标 事件 、 支 持 265 色 显 示 、 支 持 session。 
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œ | D 192.168.1.20:8000 


Open Terminal 


Light Switch 


图 9.3 ttyjjs 页 面 
(7) 在 线 游戏 : 框架 选择 Pomelo 

Pomelo 是 基于 Node.js 的 高 性 能 、 分 布 式 游戏 服务 器 框架 , 包括 基础 的 开发 框架 和 相关 的 
扩展 组 件 〈 库 和 工具 包 ) ， 可 以 省 去 游戏 开发 中 枯燥 的 重复 劳动 和 确 层 逻辑 的 开发 。 

Pomelo 的 设计 初衷 是 游戏 服务 器 。 不 过 在 设计 、 开 发 完成 后 发 现 Pomelo 是 一 个 通用 的 分 
布 式 实时 应 用 开发 框架 。 它 的 灵活 性 和 可 扩展 性 使 Pomelo ERA y E AMHA. fee 
强大 的 可 伸缩 性 和 灵活 性 ，Pomelo 在 很 多 方面 甚至 超越 了 现 有 的 开源 实时 应 用 框 染 。 

Web 和 应 用 开发 的 变化 是 非常 快 的 ， 对 大 多 数 开 发 人 员 来 说 ， 选 择 一 个 合适 的 框架 依然 
是 非常 困难 的 。 使 用 Node 框架 可 以 让 应 用 程序 迅速 构建 起 来 ， 而 不 用 过 多 地 考虑 奔 层 设计 ， 
开发 人 员 可 以 关注 扩展 应 用 程序 ， 而 不 是 重复 地 制造 已 有 的 轮子 。Node 框架 提供 了 多 种 特性 
使 得 可 以 在 不 同 的 层面 连接 资源 、 创 建 页 面 、 解 决 构建 实时 的 常见 问题 。 


温 故 知 新 
学 完 本 章 后 ， 读 者 需要 回答 : 


1. Node.js 的 框架 分 为 几 大 类 ， 每 个 类 别 有 哪 些 突出 代表 ? 
2. 在 选择 Node.js 框 染 的 时 候 有 哪些 原则 和 注意 事项 ? 
3. 实时 框架 和 非 实 时 框 染 分 别 适 用 于 开 友 哪些 应 用 ? 
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单元 测试 又 称 为 模块 测试 , 保证 了 程序 中 最 小 可 用 单元 的 可 用 性 。 在 大 型 的 软件 合作 开发 
单元 测试 显得 更 加 重要 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

使 用 Mocha 进行 单元 测试 。 

了 解 Node.js 的 原生 测试 模块 。 

了 解 Should.js 库 的 使 用 。 

了 解 Node.js V10 版 本 的 新 增 特性 。 


E 


单元 测试 介绍 


单元 测试 是 指 对 软件 中 的 最 小 可 测试 单元 进行 检查 和 验证 ， 因 此 又 称 为 模块 测试 。 在 
Node.js 中 ， 单 元 测试 往往 是 针对 茶 个 图 数 或 者 API 进行 正确 性 验证 ， 以 保证 代码 的 可 用 性 。 
这 在 团队 开发 中 显得 尤其 午 要 , 因为 团队 成 员 并 不 了 解 其 他 成 员 代码 的 写法 以 及 可 用 性 。 通过 
单元 测试 , 既 保证 了 单个 成 员 所 写 代 码 的 可 用 性 ,又 可 以 让 其 他 成 员 通 过 测试 内 容 了 解 其 函数 
或 者 API 的 使 用 。 

单元 测试 有 许多 风格 ， 和 负 见 的 风格 有 行为 驱动 开发 (BDD) 和 测试 驱动 开发 CTDD) 。 


@ 行为 驱动 开发 是 一 种 敏捷 软件 开发 的 技术 ,鼓励 软件 项 目 中 的 开发 者 、QA 和 非 技术 
人 员 或 商业 参与 者 之 间 的 协作 。 也 就 是 说 , 行为 驱动 开发 关注 的 是 整个 系统 最 终 的 实 
现 是 否 与 用 户 期 望 一 致 。 

@ 测试 驱动 开发 是 一 种 软件 开发 过 程 中 的 应 用 方法 ,最 早 在 极限 编程 中 倡导 , 基本 思想 
是 先 写 测试 程序 ， 然 后 编码 实现 功能 。 测 试 驱动 开发 的 目的 是 取得 快速 反馈 ; 使 所 有 
功能 都 是 可 用 的 。 


使 用 单元 测试 模块 Mocha 


Mocha 是 一 天 功能 非常 丰富 的 JavaScript 单元 测试 框架 ， 也 是 目前 Node.js 开发 中 最 和 常用 


第 10 章 Node.js 单元 测试 与 新 增 特性 
的 一 款 单元 测试 工具 。Mocha 同时 支持 异步 和 同步 的 测试 ， 既 可 以 运行 在 Node.js 环境 中 ， 也 
可 以 运行 在 浏览 器 环境 中 。 
10.2.1 Mocha 介绍 


Mocha 是 现在 最 流行 的 Node.js 单元 测试 框架 ,官方 网 站 地 址 为 http:/mochajs.org/, GitHub 
地 址 为 https://github.com/mochajs/mocha。Mocha 官方 网 站 页 面 如 图 10.1 所 示 。 


simple, flexible, fun 


Mocha is a feature-rich JavaScript test framework running on Node.js and in the browser, 
making asynchronous testing simple and fun. Mocha tests run serially, allowing for flexible and 
accurate reporting, while mapping uncaught exceptions to the correct test cases. Hosted on 


GitHub. 


backers 27 MW sponsors 2 


10.1 Mocha 官方 网 站 页 面 


从 Mocha 的 官方 网 站 中 可 以 了 解 到 Mocha 不 仅 可 以 运行 在 Node.js 环境 中 ， 还 可 以 运行 
在 浏览 器 中 。 同 时 ，Mocha 功能 丰富 ， 文 持 TDD、BDD 和 export 风格 的 测试 ， 并 且 文 持 异 步 
和 同步 的 测试 ， 基 本 上 能 够 满足 Node.js 所 有 单元 测试 的 需求 。 

使 用 Mocha 模块 前 首先 需要 通过 NPM 安装 这 个 模块 : 


npm install mocha -g 


或 者 不 需要 全 局 安装 ， 仅 作为 项 目的 依赖 安装 : 
npm install mocha -S 


下 面 做 一 个 简单 的 测试 ， 创 建 一 个 名 为 index.js 的 文件 ， 在 这 个 文件 中 写 入 一 个 计算 各 个 
参数 之 和 的 函数 。 
Funetlioneadorn i 
if (arguments.length > 0) ( 
/* 将 所 有 的 参数 转化 为 数组 求 和 */ 
return [].slice.call (arguments) .reduce (function (a,b) { 
TeLuUrÐ a iD, 


F) 
}else (í 


recurn Os 
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接着 对 这 个 函数 进行 测试 , 在 同 级 目录 下 创建 一 个 名 为 testjs 的 文件 , 将 上 述 函 数 引 入 后 


进行 测试 ， 写 入 以 下 代码 : 


【代码 说 明 】 
@ Hdescribe(moduleName, testDetails): 描述 将 要 测试 的 模块 。 例 如 ， 上 述 代 码 就 是 测试 
Math 模块 下 的 add() 方 法 ， 这 个 方法 可 以 髓 套 。 
© it(info, function): 测试 语句 放 在 回调 函数 中 ，info 是 正确 输出 时 的 简单 语句 描述 。 一 
个 让 对 应 一 个 实际 的 可 能 情况 。 


在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 


test 运行 之 后 的 结果 如 图 10.2 所 示 。 


图 10.2 测试 结果 
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不 过 此 时 仍然 存在 一 个 问题 ， 就 是 上 面 只 是 运行 了 代码 ， 并 没有 对 结果 进行 检查 。 例 如 ， 
对 add0 函 数 传 入 其 他 参数 ， 依 旧 会 得 到 一 样 的 结果 : 
/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 


/* 测 试 描述 */ 
qescribe("Math', Ffunction() !Í 
describe ("fadd()"; function() [ 


T£ ('Shomntad returni 0t Finection() pl 


/* 运 行 方法 */ 
lib.add(3,3); 


测试 结果 如 图 10.3 所 示 。 


Nodejs command prompt 


10.3 测试 结果 


对 结果 进行 检查 就 要 用 到 断言 库 。Nodejs 中 自 带 了 一 个 断言 库 assert, X} add 函数 进行 断 
言 测试 可 以 使 用 assert.equal0 方 法 。 现 将 textjs 文件 中 的 代码 修改 如 下 ， 并 重 命名 为 assert.js 
文件 : 


/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 


/* 引 入 断言 模块 */ 
var assert = require('assert'); 
/* 测 试 描述 */ 


clescribe("Math'; Eunmnction() i 
describe taddi) A EuSTIC E TOT i) 


TE (7 Sel returni l O 7 pue pornm IE] 


/* 测 试 断言 */ 
assert'equal("10",]ipl'aqd(5;5)); 
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在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 
mocha test í í í í í í í í í í í í í í í í í í í í í í í í í í í í í í 
test 运行 之 后 的 结果 如 图 10.4 所 示 。 


图 10.4 测试 结果 


此 时 看 上 去 和 上 文 并 没有 什么 区 别 ， 但 是 当 assert.equal0 的 期 望 值 和 实际 值 不 一 致 时 ， 将 
可 以 在 控制 台中 看 到 错误 提示 ， 如 将 add0 参 数 修改 为 以 下 内 容 : 


再 次 运行 代码 将 提示 一 个 断言 出 错 ， 如 图 10.5 所 示 。 
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10.5 断言 出 错 
assert 模块 的 主要 方法 有 以 下 几 个 : 


assert.equal() 
assert.notEqual() 


assert.fail() 
assert.deepEqual() 
assert.notDeepEqual() 


有 关 具 体 方法 的 使 用 ， 读 者 可 以 查阅 相关 的 书籍 、 文 档 等 资料 。 
读者 在 这 里 有 必要 了 解 一 下 Mocha 测试 框架 常用 的 命令 。 


@ 通过 mocha -h 或 者 mocha --help 可 以 查看 所 有 的 命令 信息 ， 如 图 10.6 所 示 。 


10.6 输入 mocha --help 命令 的 查询 结果 
© 通过 mocha -V 或 者 mocha --version 可 以 查看 Mocha 的 版 本 ， 如 图 10.7 所 示 。 


E Node.js command prompt 一 E| > 


图 10.7 Mocha 的 版 本 
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© 通过 mocha -c 或 者 mocha --colors 强制 测试 时 使 用 颜色 标记 ， 此 时 通过 的 测试 将 为 绿 
色 字 体 ， 未 通过 的 测试 将 为 红色 字体 。 例 如， 对 前 面 的 test.js 文件 使 用 这 个 命令 将 得 
到 如 图 10.8 所 示 的 结果 。 


Nodejs command prompt 


1) should return 10 
~ should return 0 


1 passing (17ms) 
1 failing 


1) Math 
#add () 
should return 10: 
AssertionError [ERR ASSERTION]: '10' == 15 
at Context. <anonymous> (assert. js:14:20) 


图 10.8 ” 带 颜 色 的 测试 结果 “〈 彩 图 见 下 载 资 源 ) 
© 通过 mocha -C 或 者 mocha --no-colors 强制 测试 时 不 使 用 颜色 标记 , 对 应 上 面 的 命令 。 


10.2.2 ”使 用 断言 库 should js 


在 上 文中 ， 我 们 使 用 Node.js 中 原生 的 断言 模块 assert 来 做 单元 测试 时 结果 的 判断 。 不 过 
原生 的 assert 模块 功能 有 限 ,这 里 介绍 男 一 球 流 行 的 断言 库 should.js。should.js 是 一 个 BDD 
测试 的 断言 库 ， 官 方 网 站 的 地 址 是 http://shouldjs.github.io/ (页 面 见 图 10.9) , GitHub 地 址 是 
https://gıthub.com/shouldjs/should.js o 


Should.js API Documentation 


< C ù G) shouldjs.github.io D | se q = » sam Ú š @ š > 


Should.js 


global 2 “global” Members 
Assertlon.add 
Assertion.alias 
PARAM_REGEXP © 
Pronisedassertion Detect tree vanable self 
TYPE_REGEXP 
format 


Assertion.add(name, func) 
fornat 


parse 

root 

should$1 Way to extend Assertion function. It uses some logic 

to define only positive assertions and Itself rule with negative assertion AJI actions happen In subcontext and this method take care about negation 
Potentially we can add some more modifiers that does not depends from state of assertion. 


© 


should .Assertion 
should .AssertionError 


Arguments 


should. config 


EE E 1. name (String): Name of assertion. It will be used for defining method or getter on Assertion. prototype 
Za E SER 2. func (Function). Function that will be called on executing assertion 
shou 


ld. use Example 
assertion 


Assertion#any 


Assertlontassert 


10.9 should.js 官方 网 站 页 面 
使 用 should.js 断言 库 前 首先 需要 通过 NPM 安装 这 个 模块 : 
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npm install should --save-dev 
安装 完成 后 通过 require0 方 法 引入 : 
var should = require ('should'}; 
使 用 should. js 改写 原生 Node.js 的 assert 模块 测试 ， 代 码 如 下 : 
/* 引 入 需要 测试 的 模块 */ 


var lib = requirel('./index'); 


/* 引 入 断言 模块 */ 
var assert = require('assert'); 
/* 测 试 描述 */ 


describe('Mathbh', function() i 
describe ('#add()', function() Í 
IE Should return l0. A EuUncCEIion ih 
Tip add(5; 9,9) -should : be-egual (15); 
J); 


tU OI Shortrif relurnu0 "ot tunct ion () mi 


lib.add() .should.be.equal (0) 


使 用 命令 行 工具 运行 以 下 命令 ， 发 现 测试 结果 符合 预期 ; 


mocha test.js -c 


有 时 测试 中 并 不 需要 明确 的 返回 结果 ， 只 需要 测试 返回 的 数据 类 型 。 这 点 利用 should js 


同样 可 以 做 到 。 将 index.js 的 内 容 修 改 为 以 下 代码 : 
/*object 类 型 判断 函数 */ 


function objType (ele) { 
if (typeof ele === "Object ' ) { 
return {} 
} else { 


return false 


/* 导 出 函数 */ 
module.exports ={ 

objType: objType 
}; 


191 


Node js 10 SAX 


这 段 代 码 非 常 简单 ， 利 用 typeof 检测 参数 的 类 型 ， 从 而 返回 不 同 的 值 。 
使 用 test.js 文件 对 这 个 方法 的 返回 值 的 数据 类 型 进行 测试 ， 将 testjs 文件 的 代码 修改 为 以 
下 代码 : 


以 上 代码 测试 一 个 普通 对 象 、 一 个 Date 对 象 、 一 个 正则 表达 式 作为 参数 时 的 返回 值 。 在 
命令 行 中 运行 以 下 命令 


可 以 看 到 测试 代码 如 期 运行 ， 如 图 10.10 所 示 。 


图 10.10 ”测试 代码 如 期 运行 
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10.2.3 测试 异步 方法 


使 用 Mocha 测试 异步 方法 非常 简单 ， 在 完成 一 个 异步 方法 的 测试 之 后 调用 一 个 回调 函数 
即 可 。 例 如 ， 将 index.js 文件 中 的 方法 修改 为 一 个 异步 方法 : 


将 testjs 文件 内 容 修改 为 对 异步 方法 的 测试 ， 代 码 如 下 : 


运行 mocha test.js -c 命令 ， 可 以 看 到 这 个 异步 方法 通过 了 测试 ， 如 图 10.11 所 示 。 


10.11 测试 异步 方法 
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10.24 路 由 测试 


在 开发 中 往往 需要 对 后 端的 API 接口 进行 测试 ，Mocha 本 身 并 没有 集成 对 路 由 API 的 测 
试 支持 ， 此 时 需要 借助 supertest 库 进 行 测试 。 当 然 ， 使 用 supertest 时 需要 先 使 用 NPM 进行 安 
装 ; 


npm install supertest --save-dev 


supertest 文 持 各 个 框架 。 这 里 以 Express 为 例 , 通过 NPM 安装 完 Express 后 新 建 一 个 名 为 
appJjs 的 文件 ， 写 入 以 下 内 容 : 


var express = require('express');/ 


var app = express (); 


/*w X. get 方法 /user 时 返回 一 个 json 数据 */ 
app.get ('/user', function (req, res) { 
res.status (200) .json({name: 'username', password: 'password'}); 


Fi; 


module.exports = app; 


这 里 通过 Express 设 定 了 一 个 返回 json 格式 的 /user 路 由 , 通过 一 个 get 请 求 就 可 以 获取 用 
户 的 姓名 和 密码 ， 这 在 实际 开发 中 是 非常 常见 的 情景 。 
将 test.js 的 文件 修改 为 使 用 supertest 测试 的 内 容 ， 代 码 如 下 : 


var app = require('./app'); 
/* 引 入 supertest*/ 


var request = require ('supertest');/ 


describe ('GET /user', function() { 
it ('should an name with password', function (done) { 
request (app) 
-get ("/user") 
.expect ('Content-Type', 'application/json; charset=utf-8') 
-expect (200, { 
name: 'username', 
password: 'password' 
], done) 
J) 
}) 


通过 mocha 测试 之 后 可 以 发 现 测试 通过 ， 如 图 10.12 所 示 。 
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图 10.12 API 测试 通过 


当 测 试 没 有 通过 时 , supertest 同样 会 在 命令 行 中 提示 用 户 。 例 如 ， 将 上 文中 测试 内 容 的 返 
回 值 username 修改 为 name， 可 以 发 现 命令 行将 会 出 现 相 应 的 提示 ， 如 图 10.13 所 示 。 


10.13 API 测试 不 通过 


10.2.5 ”测试 覆盖 率 

在 进行 单元 测试 的 时 候 , 我 们 还 需要 关注 测试 时 的 代码 履 盖 率 。 履 盖 率 一 般 包 含 行 覆 善 率 、 
RREME DLAME AAA K 4 个 维度 。 在 Node.js 中 可 以 使 用 Istanbul 工具 作为 代 
码 履 善 率 工具 ， 使 用 Istanbul 之 前 同样 需要 使 用 NPM 进行 安装 : 
npm install -g istanbul 

对 茶 个 文件 进行 测试 时 ， 直 接 使 用 istanbul cover 命令 即 可 ， 如 文件 为 ndex.js: 
istanbul cover index.js 


运行 完成 之 后 可 以 看 到 命令 行 中 已 经 显示 了 相应 的 覆盖 率 ， 如 图 10.14 所 示 。 
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图 10.14 ABARREK 

X HL IJ 28 ma 36 dR i EV Jy | J DAE Pim TK A 
这 里 可 以 看 到 测试 履 蕴 率 的 相应 结果 。 

在 测试 的 时 候 ， 同 时 结合 mocha 和 istanbul 就 可 以 实现 代码 的 全 面 测试 。 实 现 起 来 非常 简 
单 ， 使 用 以 下 命令 即 可 : 
istanbul cover mocha 

运行 完 这 段 命令 之 后 可 以 在 命令 行 中 同时 进行 mocha 的 测试 和 得 看 代码 覆 兰 率 ， 如 图 
10.15 所 示 。 


À —* > A 
AS me 


#setTimeout í 


Writing ge object g ub 
Writing coverage reports at [|F:\github\The-book-of-Node. 


10.15 ”代码 测试 与 覆盖 率 结果 
这 条 命令 同时 生成 了 一 个 名 为 coverage 的 子 文 件 夹 。 在 这 个 文件 夹 下 的 coverage.json X 
件 包含 履 盖 率 的 原始 数据 ， 同 时 在 这 个 文件 夹 下 的 lcov-report 文件 夹 下 的 文件 是 可 以 在 浏览 
器 中 打开 的 覆盖 率 报 告 。 履 冀 率 报告 包含 详细 的 说 明 ， 如 图 10.16 所 示 。 


100% Statements 12/12 100% Branches 0/0 100% Functions 57/5 100% Lines 12/12 

File a Statements Branches Functions Lines 

source Www 100% | 12/12 100% 0/0 100% | 5/5 100% 12/12 
81.25% Statements 13/16 50% Branches 1/2 83.33% Functions 576 81.25% Lines 13/16 


[| 
File a Statements Branches Functions Lines 


source/ HHGS | 81.25% | 13/16 50% | 1/2 83.33% | 5/6 81.25% | 13/16 


10.16 ERZE 
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10.2.6 ”使 用 Travis-cli 


Travis-cli 是 一 个 在 线 的、 分 布 式 的 持续 集成 服务 ， 可 以 用 来 构建 和 测试 在 GitHub 上 托管 
的 代码 ， 在 项 目的 目 动 测试 中 非常 有 用 。 使 用 Travis-cli 时 ， 首 先 需 要 在 Travis-cli 官方 网 站 使 
用 GitHub 登录 。Travis-cli 官方 网 站 的 网 址 是 https://travis-ci.org/， 如 图 10.17 所 示 。 


Test and Deploy with Confidence 


y sync your GitHub projects with Travis CI and you'll be testing your code in minutes! 


Sign Up 


green-eggs/ham © 


图 10.17 Travis-cli 官方 网 站 页 面 


使 用 GitHub 账号 登录 之 后 ， 就 可 以 选择 需要 打开 Travis-cli 的 GitHub 仓库 。Travis-cli 会 
把 项 目 默 认 当 作 Ruby MH, KE Node.js 项 目 需 要 在 根 目录 下 加 入 .travis.yml 文件 ， 并 通过 这 
个 文件 来 对 项 目 进行 摘 述 : 

Tanguage: node Js 


pode js: 
ar "(5 412" 


配置 完 .travis.yml 文件 以 后 ， 在 每 次 提交 的 时 候 就 可 以 进行 目 动 构 建 了 。 


Node.js v10 中 实现 异步 请 求 的 单元 测试 


通常 ， 在 使 用 Node.js 原生 的 断言 模块 assert 判断 函数 预期 错误 时 ， 会 用 到 throws0 方 法 做 
单元 测试 。 但 是 ，throws() 方 法 对 于 异步 请 求 操作 没有 提供 很 好 的 文 持 ， 这 是 Node.js 早期 版 
本 中 功能 不 完善 的 地 方 。 

因此 ， 该 功能 在 Node.jjs v10 版 本 中 得 到 了 完善 ， 新 版 本 中 增加 了 一 个 rejects0 方 法 实现 了 


197 


Node.js 10 实战 


对 异步 请 求 操作 进行 单元 测试 的 支持 。 从 语法 上 来 看 ，throws(0) 方 法 和 rejects0 方 法 好 比 是 一 
对 挛 生 兄弟 ， 只 不 过 rejects(0) 方 法 增加 了 对 Promise 对 象 的 支持 。 
下 面 是 throws0 方 法 的 语法 描述 : 


assert.throws (block[, error][, message]) 
参数 说 明 : 


@ block: <Function> 
@ error: <RegExp> | <Function> | <Object> | <Error> 


@ message: <string> | <Error> 


断言 block 函数 会 抛 出 错误 。eror 可 以 是 Class、RegExp、 校 验 函 数 、 每 个 属性 都 会 被 测 
试 是 否 深 上 度 全 等 的 校 验 对 象 或 每 个 属性 (包括 不 可 枚 举 的 message 和 name 属性 ) 都 会 被 测试 


是 否 深度 全 等 的 错误 实例 。 当 使 用 对 象 时 ， 可 以 使 用 正则 表达 式 来 校 验 字符 串 属 性 。 
下 面 是 rejects0) 方 法 的 语法 描述 : 


assert.rejects (block[, error][, message]) 
参数 说 明 : 


@ block: <Function> | <Promise> 
@ error: <RegExp> | <Function> | <Object> | <Error> 


@ message: <string> | <Error> 


等 符 block HJ Promise s. WR block 是 一 个 函数 ， 束 立即 调用 该 函数 并 等 竺 返回 的 
promise 完成 ， 然 后 检查 promise 是 否 被 reject。 

# block 是 一 个 图 数 且 同步 地 抛 出 一 个 错误 ， 则 assert.rejects0 会 返回 一 个 被 reject 的 
Promise 并 传 入 该 错误 。 寿 该 函数 没有 返回 一 个 promise， 则 assert.rejects() 返 回 一 个 被 reject 
的 Promise 并 传 入 ERR_INVALID RETURN _VALUE 错误 。 以 上 两 种 情况 都 会 跳 过 错误 处 理 
函数 。 

下 面 做 一 个 简单 的 测试 ， 创 建 一 个 名 为 throws.js 的 文件 ， 在 这 个 文件 中 写 入 一 个 简单 的 
单元 测试 。 

/* 引 入 断言 模块 */ 


var assert = require('assert'); 


/* assert throws */ 
assert.throws ( 
(Euncetion (y 
throw new Error (" 错 误 信息 ") ; 
FO): 


Por p ey 
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【代码 说 明 】 
© throws(0 方 法 的 block 参数 定义 为 一 个 目 执 行 函 数 ， 在 函数 内 定义 了 一 个 抛 出 错误 信 
TRES. 


@ throws() 方 法 的 error 参数 定义 为 一 个 Error 对 象 。 
在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 


node throws.js 


运行 之 后 的 结果 如 图 10.18 所 示 。 


图 10.18 ”throws0 方 法 的 测试 结果 


为 了 实现 异步 请 求 操 作 的 单元 测试 ， 下 面 尝 试 一 下 将 throws0 方 法 的 block 参数 定义 为 一 
个 Promise 对 象 。 


/* 引 入 断言 模块 */ 


var assert = require('assert'); 


/* Promise */ 
var p = new Promise (function (resolve, reject) { 


// 做 一 些 异 步 操作 
setTimeout (function () { 
console.1og(' 执 行 完 成 '); 
resolve (' 随 便 什么 数据 ') ; 
}, 2000); 
)); 


p-then (function (data) | 
console.log (data); 


I); 


(s nsserElERroOws A*I 


assert.throws ( 


Pr 


199 


Node.js 10 SAX 


Pop ey 


运行 之 后 的 结果 如 图 10.19 所 示 。 


10.19 throws() 方 法 测试 Promise 对 象 的 结果 


从 图 10.19 中 的 输出 结果 来 看 ，assert.throws() 方 法 是 不 文 持 使 用 Promise 对 象 的。 下 面 是 
新 增 的 assertrejects() 方 法 发 挥 作 用 的 时 候 了 。 将 throwsjjs 文件 中 的 代码 修改 如 下 ， 并 重 命名 
为 rejects.js 文件 : 
/* 引 入 断言 模块 */ 


var assert = require('assert'); 


/* Promise */ 
var p = new Promise (function (resolve, reject) { 
// 做 一 些 异 步 操作 
setTimeout (function () í 
console.1log(' 执 行 完 成 ') ; 
resolve (' 随 便 什 么 数据 ' ) ; 
), 2000); 
H? 


p then (function (data) | 
console.log (data); 


}); 


.asSserne ENTOWS a 


assert.rejects ( 


Pr 
Error 


在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 
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node rejects.js 


运行 之 后 的 结果 如 图 10.20 所 示 。 


图 10.20 ”rejects0 方 法 的 测试 结果 


从 图 10.20 输出 的 结果 来 看 ， 异 步 方法 setTimeout0 中 的 定义 语句 全 部 得 到 了 输出 ， 说 明 
assertTejects() 方 法 完美 地 支持 了 异步 Promise 对 象 。 


1 .4A， 温 帮 知 新 


学 完 本 章 后 ， 读 者 需要 回答 : 


1. 单元 测试 的 意义 是 什么 ? 

2. Node.js 单元 测试 的 简单 使 用 。 

3. Mocha 的 简单 使 用 。 

4. assert 断言 模块 新 增 rejects0 方 法 的 使 用 。 
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Nodejs 的 知识 在 前 面 基本 已 经 介绍 完毕 ， 本 章 将 介绍 Node.js 有 关 的 其 他 内 容 ， 包 括 与 
Node.js MHRA AKEJ Nginx 与 PM2， 以 及 Facebook 新 推出 的 包 管 理 器 Yarno 
通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


@ Nginx 的 简单 配置 和 使 用 。 
© PM2 模块 守护 进程 的 使 用 。 
© Yam 作为 新 一 代 包 管理 器 的 优势 以 及 使 用 。 


使 用 Nginx 


Nginx 是 一 个 开源 、 高 效 、 高 性 能 的 HTTP 和 反 回 代理 服务 器 。Nginx 是 由 一 位 俄罗斯 的 
程序 员 设 计 开 发 的 ， 并 且 源 代码 以 BSD 许可 证 形式 发 布 。Nginx 和 凭 从 高 稳定 性 、 丰 旦 的 功能 
集 、 示 例 配 置 文件 和 低 系统 资源 的 消耗 而 于 名 。 在 高 连接 并 发 的 情况 下 ,Nginx 是 不 错 的 Apache 
葵 代 品 ， 目 前 国内 的 大 型 互联 网 公司 都 部 车 了 Nginx， 如 腾讯 、 新 浪 、 网 易 、 阿 里 巴巴 等 。 

Nginx 可 以 作为 负载 均衡 服务 器 。Nginx 既 可 以 在 内 部 直接 文 持 Rails 和 PHP 程序 对 外 进行 服 
务 ， 也 可 以 作为 HITP 代理 服务 器 对 外 进行 服务 。Nginx 采用 C 语言 编写 , 不 论 是 系统 资源 开销 还 
是 CPU 使 用 效率 都 要 比 Perlbal 好 得 多 。 同 时 ，Nginx 也 是 一 蒜 非 常 优秀 的 邮件 代理 服务 器 。 

Nginx 的 官方 网 站 地 址 为 http://nginx.org/， 页 面 如 图 11.1 所 示 。 


ZED GD 2V HLI 420 IND AMH 


NGINX Plus R16 released with enhanced clustering, load balancing, and security feature 


nginx news 
2018-08-28 nginx-1.15.3 mainline version has been released. 


2018-07-31 njs-0.2.3 version has been released, featuring String. bytesFrom0, String.padStart(), 
String.padEnd0 methods support and more. 


2018-07-24 nginx-1.15.2 mainline version has been released 
2018-07-13 unil-1.3 version has been released. 


2018-07-03 nginx-1.15.1 mainline version has been released, featuring random load balancing 
nethod, 


2018-06-19 njs-0.2.2 version has been released, featuring HTTP internalRedirect) method support 
and more. 


2018-06-07 Unit-12 version has been released with setti 
d d Pi f Qi p tions. 


2018-06-05 nginx-1.15.0 mainline version has been released. 


2018-05-31 njs-0.2.1 version has been released. 


ightfunnel.coemn i> TLSE.. Packt has published yet anoth ook about nginx: “Nginx HTIP Serye 


图 11.1 Nginx 官方 网 站 页 面 
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Nginx 支持 各 大 操作 系统 ， 下 面 介 绍 其 安装 方法 。 


11.1.1 在 Linux 下 安装 Nginx 
在 Linux 下 安装 Nginx 需要 注意 的 是 , 在 下 载 安 装 前 要 下 载 和 安装 相应 的 编译 工具 和 库 文 件 。 
(1) 安装 编译 工具 和 库 文 件 : 
yum -y install make zlib zlib-devel gcc-c++ libtool openssl openssl-devel 
(2) 下 载 PCRE library 库 : 
wget http://downloads.sourceforge.net/project/pcre/pcre/10.32/pcre-10.32.tar.gz 
(3) 解压 : 
tar zxvf pcre-10.32.tar.gz 
(4) 安装 : 


cdipere 10732 
<Aconf igure 


make && make install 
(5) F4 Nginx: 

wget http://nginx.org/download/nginx-1.15.3.tar.gz 
(6) 安装 Nginx: 


-/configure--prefix=/usr/local/webserver/nginx--with-http_ stub status module-- 
with-http ssl module--with-pcre=/usr/local/src/pcre-10.32 


make instal 


(7) 进入 相应 的 目录 执行 Nginx 可 执行 文件 。 


11.1.2 # Windows 下 安装 Nginx 


在 Windows 下 只 需要 下 载 解压 即 可 使 用 ， 下 载 地 址 为 http://nginx.org/en/download.html。 
运行 nginx.exe 即 可 启动 服务 ， 在 浏览 器 中 打开 可 以 看 到 如 图 11.2 所 示 的 页 面 ， 说 明 Nginx 已 
经 运行 起 来 了 。 
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文件 日 ”编辑 日” 查看 (W) 历史 (S) 书签 (8) 工具 中 ”帮助 (H) 


Welcome to nginx! x | 十 


< C @Q G) localhost:8090 


Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and 
working. Further configuration is required. 


For online documentation and support please refer to nginx.org. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 


图 11.2 Nginx 运行 成 功 页 面 


11.1.3 Nginx 的 配置 


要 运行 网 站 ， 还 需要 对 Nginx 做 一 些 配置 。 在 nginx 文件 夹 的 conf 子 文件 夹 下 的 
nginx.config 文件 就 是 Nginx 的 配置 文件 ， 内 容 如 下 : 


#user nobody; 


worker processes l; 


#error log logs/error.log; 
#error log logs/error.log notice; 


#error log logs/error.log info; 


#pid logs/nginx.pid; 
events { 

worker connections 1024; 
} 
WEED 

include mime .types; 


default type application/octet-stream; 


flog ormat main renaokcesadgodr Sremote user [St imeTlocal] eu 
# AE SIG Dy os s Oy IPS t Dp eterer ni 
# "ShttEp user agent” "Shttp X forwarded Form; 


#access log logs/access.log main; 


sendfile on; 


#tcp nopush Om; 


#keepalive timeout 0; 
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# 符 号 代表 注释 。 下 面 给 出 这 些 配置 的 一 些 说 明 ， 参 照 这 些 说 明 即 可 部 署 好 静态 资源 。 
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# 使 用 Nginx 的 用 户 名 


#user nobody; 


#cpu 数 ， 一 般 设置 为 和 服务 器 的 cpu 数 一 致 


worker processes 1; 


#error log logs/error.log; 
terror log logs/error.log notice; 


#error log logs/error.log info; 


# 进 程 id 
#pid Togqs/nginx pid; 


events { 


worker connections 1024; 


hitiph[ 
# 设 置 mime 类 型 ， 类 型 由 mime .types 文件 定义 
include mime .types; 


default type application/octet-stream; 


# 设 定 日 志 格式 

flog format main "Sremote addi — sremete user |SLime local] "Srequestm':s 
# > [d SE Ly = 

# "Shi Lp user agent “SnEcp xz Forwarded for "> 


#access log logs/access.log main; 


#sendfile 指令 指定 Nginx 是 否 调 用 sendfile Mt (zero copy 方式 ) 来 输出 文件 。 对 于 普通 应 
用 ， 必 须 设 定 为 on; 如 果 用 来 进行 类 似 下 载 操作 的 磁盘 ro 重负 载 应 用 ， 可 设置 为 off， 以 平衡 磁盘 与 网 络 
I/O 的 处 理 速 度 ， 降 低 系统 的 uptime 


sendfile on; 
#tcp_nopush 9) 552 
# 设 置 超时 时 间 


#keepalive timeout 0; 


keepalive timeout 65; 
# 是 否 开启 gzip 压缩 《网 页 速度 优化 非常 有 用 ， 开 局 后 通常 可 以 达到 70% 的 压缩 率 ) 
#gzip on; 


server (í 


# 侦 听 端 口 
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11.1.4 使 用 Nginx 部 署 网 站 


使 用 Nginx 可 以 非常 简洁 快速 地 部 署 Web 站 点 ,尤其 是 同时 部 署 包含 多 个 Node.js 应 用 的 


站 点 


¿tO 


首先 ， 假 如 现在 有 一 个 运行 在 3000 端口 的 Node.js 应 用 ， 可 以 直接 利用 Nginx 作为 反 向 
代理 ， 同 时 还 可 以 将 资源 交 由 Nginx 来 处 理 ， 这 样 该 Node.js 应 用 对 外 表现 的 就 好 像 是 运行 在 


80 mO. RAREN IKEE Nginx 配置 文件 中 添加 一 个 server 类 ， 内 容 如 下 : 


server { 


} 


然后 ， 假 设 现在 还 有 一 个 Node.jjs 应 用 运行 在 3001 端口 ， 仍 可 以 直接 利用 Nginx 作为 反 


listen 20s 


# 域 名 


server name www.nginxnodeapp.com; 


Tocation A FI 
#node.js 应 用 的 端口 
proxy pass http://127-0.0:1:3000; 
root E:\WebstormProjects\NodejsDev\chapterll\nginxnodeapp; 
proxy redirect off; 
proxy http version l.l; 
proxy set header Host $host:$server port; 
proxy set header X-Real-IP $remote addr; 
proxy set header X-Forwarded-For $proxy add x forwarded for; 
proxy _set_header X-NginX-Proxy true; 
proxy read timeout 300s; 


} 

# 静 态 文件 交 给 Nginx 直接 处 理 

#location ~ .*N.(gifl|jpgljpeg|png|bmp|swfl|ico)%$ { 

# root E:NWebstormProjectsNNodejsDevNchapterllNnginxnodeapp; 
# accesa log ofi; 

# expires 24h; 

#) 


回 代 理 。 有 具体 部 署 方法 是 在 Nginx 配置 文件 中 再 添加 一 个 server 类 ， 内 容 如 下 : 


server { 
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listen 80; 


# 域 名 


server name m.nginxnodeapp.com; 


location / { 
#node.js 应 用 的 端口 
proxy pass DEEP 大 站 2 0 .D.1:3001; 
root E:NWebstormProjectsNNodejsDevNchapterllNnginxnodeapp; 
proxy redirect off; 
proxy NEED version. i i; 
proxy set header Host $host:$server port; 
proxy set header X-Real-IP $remote addr; 
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proxy set header X-Forwarded-For S$SPIOXY add x forwarded for; 
proxy set header X-NginX-Proxy true; 
proxy read timeout 300s; 


} 
# 静 态 文件 交 给 Nginx 直接 处 理 
#location ~ .*N.(gif|jpgljpeg|png|bmp|swfl|ico)$ { 


# root E:NWebstormProjectsNNodejsDevNchapterllNnginxnodeapp; 
# access log off; 

# expires 24h; 

#) 


) 


下 面 通过 浏览 器 测试 一 下 使 用 该 Nginx 配置 的 Node.js Web 站 点 。 首 先 ， 在 浏览 器 中 输入 
地 址 localhost， 如 图 11.3 所 示 。 


240 S850 EEV 历史 (S| #26) ISM 帮助 (H) 


pa Welcome to ngine! x | 十 


< G | © localhost GE … V? > 


Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and 
working. Further configuration is required. 


For online documentation and support please refer to nginx.org. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 
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然后 ， 继 续 在 浏览 器 中 输入 地 址 http:/www.nginxnodeapp.com， 如 图 11.4 所 示 。 


XO SSH EEV PLO 书签 日 ISM 帮助 (H) 
nginxnodeapp.com/ x | 十 


< Ea O www.nginxnodeapp.com B 


Hello nginx-node-app! 


图 11.4 Nginx 配置 多 个 域名 的 Node js 应 用 (二 ) 


最 后 ， 继 续 在 浏览 器 中 输入 地 址 http://m.nginxnodeapp.com， 如 图 11.5 所 示 。 


XH SS EEV PLO HEG) 工具 中 ”帮助 (H) 
m.nginxnodeapp.com/ x FEF 


€ G! © m.nginxnodeapp.com 


Welcome, nginx-node-app! 


11.5 Nginx 配置 多 个 域名 的 Node.js 应 用 (三 ) 
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这 里 说 明 一 下 ， 利 用 二 级 域名 是 一 种 充分 利用 域名 资源 的 方法 。 同 样 ， 也 可 以 利用 路 径 ， 
这 和 服务 器 内 部 采用 的 映射 方式 有 关 。Nginx 就 不 能 根据 路 径 ， 但 是 可 以 使 用 二 级 域名 使 不 同 
应 用 运行 在 同一 个 一 级 域名 下 。 


11.2 Yarn 一 一 新 的 包 管 理工 具 


2016 年 ，Facebook 发 布 了 一 款 包 管 理 器 一 一 Yam， 和 希望 可 以 成 为 一 个 替代 NPM 的 快速 、 
可 靠 和 安全 的 包 管理 器 。Yarmn 作为 一 个 JavaScript 软件 包 管 理 器 ， 主 要 有 以 下 几 个 功能 : 


离线 模式 : 只 要 是 用 户 已 经 下 载 过 的 包 ， 即 使 离线 也 可 以 再 次 安装 。 

网 络 恢复 : 下 载 软件 包 失 败 后 会 自动 重新 请 求 ， 这 样 就 可 以 避免 整个 安装 过 程 失败 。 
多 个 注册 表 : 既 能 从 NPM A Bower 安装 任何 包 ， 也 能 保证 各 平台 依赖 的 一 致 性 。 
网 络 性 能 : Yan 会 对 请 求 进行 高 效 的 排队 ， 避 免 出 现 请 求 瀑布 (waterfall ) ,便于 将 
网 络 的 使 用 效率 达到 最 大 化 。 

扁平 化 模式 : 将 不 匹配 的 依赖 版 本 解析 为 同一 个 版 本 ， 避 免 重复 创建 。 

确定 性 : 无 论 安装 顺序 如 何 ， 相 同 的 依赖 在 每 台 机 器 上 都 会 以 完全 相同 的 方式 进 
行 安装 。 


Yarn 的 GitHub 地 址 为 https://github.com/yarnpkg/yarn， 官 方 网 址 为 https://yarnpkg.com/。 
同时 ， 在 官方 网 站 上 可 选择 对 应 的 中 文 版 ， 对 于 国内 的 开发 者 来 说 还 是 相对 便捷 的 。Yarn 的 
官方 网 站 页 面 如 图 11.6 所 示 。 


WAO SAD FEV PG) 书签 (B) IED #E(D _ o x 


(> C @  |Q BR htps/marnpkecomzhH R — w Qer | nOs s m ë LU & > = 


@ > 新 手指 南 “文档 包 博客 st 四 P D O Í 


FE. J., ZERE, 


立刻 开始 ! 安装 YARN | © Star | 33,151 | 


稳定 版 : v1.9.4， 候选 发 布 版 本 v1.10.0 
Nodejs 版 本 : ^4.8.0 || A5.7.0 || A6.2.2 || >=8.0.0 


图 11.6 Yarn 官方 网 站 页 面 


Yarm 的 安装 非常 便捷 ， 官 方 提供 了 Mac OS. Windows, Linux 三 种 操作 系统 的 详细 安装 
方法 。 以 Windows 为 例 ， 用 户 可 以 通过 下 载 .msi 文件 、Chocolatey、Scoop 三 种 方法 安装 。 
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(1) 利用 .msi 文件 安装 时 ， 直 接 下 载 后 单 击 安装 即 可 。 不 过 ， 在 这 之 前 用 户 应 该 确保 已 
经 安装 了 Node.js。 
(2) 利用 Chocolatey 安装 时 ， 执 行 以 下 命令 安装 即 可 : 


choco install yarn 
这 个 命令 将 确保 用 户 安装 Node.js。 
(3) 利用 Scoop 安装 时 , 使 用 以 下 命令 即 可 , 不 过 在 这 之 前 也 要 确保 已 经 安装 了 Node.js: 
scoop install yarn 


Yarm 安装 完成 后 可 以 使 用 yarn--version 命令 来 查看 Yam 的 版 本 ， 如 图 11.7 所 示 。 


yarn --version 


EEN Command Prompt 


D: NVarnsbin2>2uarn —-version 
1.9.4 


图 11.7 查看 Yam 版 本 


Yam 的 使 用 非常 简单 ， 当 开发 者 开始 一 个 新 项 目 时 ， 类 似 于 npm， 只 需要 使 用 yarm init 
命令 并 且 填 写 部 分 项 目 信 息 即 可 生成 一 个 package.json 文件 ， 如 图 11.8 所 示 。 


yarn Init 


EEN Visual Studio 2008 Command Prompt 


E: WebstormProjects‘WodejsDevchapterii\yarnapp?yarn init 
yarn init vi.9.4 

question name | 

question version (1.9.0): 

question description: 

question entry point 《index-Jjs>: 

question repository url: 

question author: king 

question license 《MIIT>: 


question private: 


Saved package .json 
Done in 34.89s. 


图 11.8 yam init 命令 需要 填写 的 信息 


一 个 典型 的 通过 yarn init 命令 生成 的 package.json 文件 内 容 大 致 如 下 : 


“names king 
EEESInne :0 0 
“main -Tndex Sss; 
CemSsee MIT 


"dependencies": {} 
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Yamn 安装 、 升 级 、 移 除 依 赖 包 分 别 使 用 add. upgrade, remove 命令 关键 字 。 例 如 ， 安 装 、 
升级 、 移 除 Koa 框架 的 命令 为 : 
yarn add koa 


yarn upgrade koa 


yarn remove koa 


在 安装 和 升级 相关 依赖 包 的 时 候 可 以 在 依赖 包 后 指定 安装 和 升级 到 对 应 的 版 本 , 只 需要 使 
用 @ 符 号 即 可 : 


yarn add package@versioin 


yarn upgrade package@version 


在 初次 安装 依赖 包 的 时 候 会 生成 一 个 yarn.lock 文件 。 这 个 文件 的 作用 是 保证 安装 包 的 依 
赖 关 系 在 跨 平台 安装 时 是 一 致 的 ， 也 就 是 上 文中 提 到 的 确定 性 。 

类 似 于 npm, Yar 同样 支持 一 次 性 安装 package.json 文件 中 的 所 有 依赖 包 。 使 用 yarm install 
命令 即 可 完成 这 项 任务 : 


yarn install 


这 个 命令 还 有 很 多 选项 ， 如 安装 一 个 包 的 单一 版 本 时 添加 -fat 选项 ， 强 制 重新 下 载 使 用 
-force 选项 ， 只 安装 生产 环境 依赖 则 使 用 --production 选项 : 
yarn install -flat 


yarn Insta ii Force 


yarn install — production 


Yam 的 使 用 大 致 如 此 ， 如 果 读 者 需要 获取 更 多 关于 Yarm 的 知识 ,请 阅读 官方 网 站 的 详细 
指南 和 文档 。 


De | EO 


4591 458 
x < 
| PM2 
区 : w 


我 们 知道 在 开发 中 一 个 进程 会 在 用 户 退 出 终端 之 后 直接 关闭 ， 这 个 进程 也 会 被 关闭 ， 而 
Node.js 应 用 常常 会 因为 一 个 错误 而 导致 进程 终止 ，Nodejjs 服务 也 随 之 关闭 。 因 此 在 线 上 部 署 
应 用 的 时 候 有 必要 使 Nodejjs 应 用 以 守护 进程 的 方式 来 局 动 。 PM2 正 是 这 样 的 一 球 Node.js 应 
HEFE E HEA o 

PM2 的 GitHub 地 址 是 https://github.com/Unitech/pm2, 官方 网 站 地 址 为 http://pm2.keymetrics.io/。 
(EH Node.js 之 前 需要 使 用 NPM 来 安装 PM2: 


rip install pm2 g 


使 用 PM2 开局 一 个 进程 非常 简单 ， 只 需要 使 用 以 下 命令 即 可 : 


pm2 start app.js 
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其 中 ，appjjs 为 将 要 以 守护 进程 方式 启动 的 Node. js 应 用 文件 。 
类 似 于 其 他 的 模块 ， 使 用 -h 命令 可 以 看 到 PM2 的 所 有 命令 ， 如 图 11.9 所 示 。 


pma hn 


L help output usage information 
V, --version output the version number 


ist without formatting 


eS (for networked app) (load balanced) 
e (error and out are both included) 


= ull btuirmpi i > =s me final SIGKILL signal to proces 
--]isten-timeou S timeout application TREES 
--max-memory-restart <memory> specify max memory amunt used to autorestart (in oc 


图 11.9 PM2 的 命令 提示 


当 PM2 开启 了 大 量 的 Node.js 应 用 时 ， 可 以 使 用 list 命令 列 出 当前 运行 的 所 有 应 用 ， 如 图 
11.10 所 示 。 


pm2 List 


CG:sers\Administrator\Desktop>pm2 list 


! 日 30.3 MB 
! AYA 9z 31.1 MB 
' 23' 0x 26.1 MB 


Use “pm2 show <idiname>` to get more details about an app 


R| 11.10 PM2 列 出 的 应 用 
需要 提醒 的 是 ， 图 11.10 中 的 数字 代表 Node.js 应 用 的 id 号 ， 当 需要 停止 Nodejs 应 用 的 
时 候 ， 只 需要 使 用 id 即 可 : 
pm2 stop id 


all 关键 字 代 表 当 前 运行 的 所 有 进程 ， 也 可 以 使 用 这 个 方法 停止 所 有 的 Node.js MH: 


Bn2 stop all 


-个 Nodejjs 应 用 运行 之 后 会 占用 越 来 越 多 的 内 存 ， 这 时 需要 重启 Node.js 应 用 。PM2 提 
供 了 restart 命令 来 重新 局 动 一 个 Node.js MH o 
重启 一 个 Node. js 应 用 的 命令 


pm2 restart id 


重启 所 有 的 Node.js 应 用 的 命令 : 


pm2 restart all 
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L L A: 使 用 Koa 


Koa 框架 是 由 Express 框架 的 原 班 人 马 打 造 而 成 的 .这 个 Web 框架 的 目标 是 成 为 一 个 更 小 、 
更 富 表 现 力 、 更 健壮 的 Web HER. Koa 框架 解决 的 主要 问题 是 大 量 的 回调 函数 嵌 套 ， 也 就 是 
第 说 的 “回调 地 狱 ”， 而 且 Koa 不 在 内 核 中 绑 定 任何 中 间 件 ， 提 供 的 仅仅 是 一 个 图 数 库 ， 这 
让 Web 开发 更 加 轻快 。Koa 是 一 个 面向 未 来 的 框架 。 

Koa 框架 官方 网 站 的 地 址 是 http://koajs.com/， 相 应 的 GitHub 地 址 为 https://github.comykoajs/koa。 

使 用 Koa 框架 之 前 同样 需要 通过 NPM 安装 : 


npm install koa 


完成 安装 之 后 就 可 以 在 项 目 中 使 用 了 。 
一 个 简单 的 Koa 应 用 程序 如 下 : 


const koa = require ('koa'); 
const app = new koa(); 


app-use (ctx >] 
ctx.body = 'hello world'; 
J); 


app-listen(3000); 


启动 这 个 应 用 就 可 以 在 本 地 的 3000 端口 看 到 一 个 简单 的 Web 应 用 。 

Koa 应 用 得 益 于 大 量 的 中 间 件 ， 因 此 Koa 中 最 常用 的 方法 是 koa.use()〈 将 给 定 的 函数 作 
为 中 间 件 加 载 ) 。 

Koa 将 req 和 res 对 象 封装 成 一 个 ctx 上下文 对 象 ， 可 以 通过 ctx request 和 ctx response 对 
象 访问 相应 的 方法 和 属性 ， 如 图 11.11 和 图 11.12 所 示 。 


11.11 通过 ctx.request 访问 
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Node.js command prompt - node indexjs 


11.12 通过 ctx.response 访问 
在 Koa 中 ，ctx 上 下 文 对 象 的 主要 API 有 : 
ctx.req: Node.js 中 的 request 对 象 。 
ctx.res: Node.js 中 的 response 对 象 。 
ctx.app: app 实例 。 
ctx.state: 命名 空间 。 
ctx.cookies.get(name,[options]): 返回 相应 的 cookie. 
ctx.cookies.set(name,value,[options]): 设置 新 的 cookie. 


上 面 两 个 API 中 的 options 参数 如 下 : 


signed: Boolean, 

expires: Date, 

path: String， 默 认为 '/'， 
Ciesa r: PS L r ircj r; 

secure: Boolean, 

httpOnly: Boolean， 默 认为 true 


© ctx.throw(msg, [status]): 抛 出 错误 的 辅助 方法 ， 默 认 status 为 500. 
@ ctx.assert(value, [msg], [status], [properties]): 用 来 断言 的 辅助 方法 。 


Request 对 象 昔 用 的 API 有 : 


req.header: 返回 请 求 头 。 

req.method: 返回 请 求 方法 。 

req.method=: 设置 method。 

req.url: 返回 请 求 url。 

req.url=: 设置 url。 

req.path: 返回 path. 

req.path=: 设置 path. 

req.querystring: 返回 查询 字符 串 ， 去 除 头 部 的 “? ”。 
req.ip: AER IP. 

req.ips: 返回 请 求 IP 列表 。 
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Response 对 象 的 API 主要 有 : 


res.header: 获取 返回 头 。 

res.status: 获取 返回 的 HITP 状态 码 。 
res.status=: 设置 状态 法 。 

res.length: 返回 content-length 属性 。 
res.length=: 设置 content-length。 

res.body: 获取 响应 体 。 

res.body=: 设置 响应 体 。 

res.get(field): 获取 相应 的 返回 头 属性 。 
res.set(field, value): 设置 相应 的 属性 值 。 
set.set(fields): 一 次 设置 多 个 ， 参 数 为 对 象 。 
res.remove(fields): 删除 指定 的 返回 头 属 性 。 
res.type: 获取 返回 的 content-type。 
res.type=: 设置 content-type。 
res.redirect(url,[alt]): 重 定向 ， 可 以 使 用 关键 字 back 返回 上 一 个 页 面 (refer) ， 没 有 
refer 时 ， 返 回 “/”。 


更 多 关于 Koa 框架 的 应 用 可 以 通过 相应 的 书籍 进行 学 习 和 查阅 。 
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第 12 章 
使 用 ExXpress 开 发 个 人 博 品 系统 


如 今 个 人 博客 越 来 越 普 衣 。 越 来 越 多 的 技术 人 员 通 过 个 人 博客 来 和 外 界 交 流 技 术 和 提高 目 
己 。Express 是 如 今 较为 流行 和 稳定 的 Node.js 框架 ， 甚 至 有 人 基于 Express 提出 了 MEAN JR 
KIMA MySQL 则 是 传统 广 受 欢迎 的 开源 SQL 数据 库 。 本 章 将 通过 实际 编码 实现 一 个 由 
Express 和 MySQL 搭建 的 个 人 博客 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 一 个 完整 项 目的 开发 流程 。 

© Express 框架 的 实际 使 用 。 

© Express 5 MySQL 数据 库 的 结合 使 用 。 

@ 一 个 博客 项 目 实现 的 要 点 。 


项 目 准备 


12.1.1 项 目 概述 

PAE 21 世纪 初 兴起 的 一 种 表达 个 人 思想 、 积 累 个 人 知识 、 与 他 人 交流 沟通 的 社会 媒体 。 
ERA RAHA RRRA, 博客 成 为 目 媒 体 中 不 可 和 忽视 的 力量 。 在 技术 人 员 中 ,博客 往往 
是 个 人 知识 积累 的 一 个 平台 ， 也 是 别人 了 解 目 己 的 途径 ,可 以 说 每 一 个 技术 人 员 都 应 该 有 一 个 


目 己 的 博客 。 
本 章 将 通过 一 个 简单 的 个 人 博客 系统 让 读者 了 解 和 洁 握 一 个 项 目的 开发 。 在 本 章 中 , 我 们 


选择 的 框架 是 Express， 数 据 库 是 MySQL。 关 于 Express 和 MySQL 的 基础 知识 ， 读 者 可 以 通 
过 本 书 前 面 的 章节 或 者 其 他 相关 的 书籍 进行 了 解 和 掌握。 在 这 个 项 目 中 , 网 站 访问 者 可 以 浏览 
作者 发 布 的 文章 和 信息 ， 通 过 登录 即 可 发 布 、 修 改 、 删 除 文 章 。 


12.1.2 Wima iit 
个 人 博客 网 站 最 重要 的 是 内 容 ， 因 此 在 博客 网 站 的 首页 就 应 该 让 读者 了 解 到 作者 的 文章 ， 
而 不 是 像 企业 网 站 那样 显示 大 量 有 关 企 业 产品 的 介绍 。 博 客 首页 的 主要 内 容 可 以 是 文章 的 标 
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题 ， 让 读者 通过 标题 迅速 了 解 相关 的 领域 并 找到 自己 需要 的 内 容 。 

当然 ,一 个 博客 网 站 还 需要 有 博 主 的 个 人 介绍 页 面 等 ， 因 此 同样 需要 用 一 个 navigation 来 
跳 转 到 各 个 页 面 。 因 为 这 里 个 人 博客 网 的 链接 并 不 多 ， 所 以 通过 一 个 侧 边栏 来 实现 这 个 功能 是 
比较 合适 的 。 因 为 所 有 的 页 面 都 应 该 是 能 够 互相 跳 转 的 ， 所 以 这 个 侧 边 栏 应 该 每 个 页 面 都 需 
要 。 为 了 让 整个 博客 页 面 显得 更 加 完整 ， 为 每 一 个 页 面 添加 同样 的 header 和 footer 是 很 有 必 
要 的 。 

可 以 大 致 将 整个 个 人 博客 项 目 分 为 首页 、 内 容 页 、 文 章 编辑 页 、 登 录 页 。 首 页 、 内 容 页 、 
文章 编辑 页 都 需要 侧 边 栏 、header、footer。 登 录 页 用 一 个 简单 的 表单 实现 即 可 。 首 页 、 内 容 
页 、 文 草编 辑 页 大 致 可 以 设计 为 图 12.1~ 图 12.3 所 示 的 样子 。 


Header 


footer 


12.1 博客 首页 设计 稿 


Header 


文章 内 容 显 示 区 


footer 


| 
图 12.2 博客 内 容 页 设计 稿 
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Header 


文章 标题 编辑 区 


文章 内 容 编 辑 区 


footer 


图 12.3 博客 文章 编辑 页 设计 稿 


博客 登录 页 是 一 个 简单 的 登录 表单 , 为 了 让 这 个 页 面 不 至 于 太 单 调 , 可 以 选择 一 张 合适 的 
图 片 作 为 背景 。 登 录 页 的 设计 稿 如 图 12.4 所 示 。 


大 图 背景 


图 12.4 登录 页 设计 稿 
至 此 ， 整 个 项 目的 框架 设计 就 基本 完成 了 。 


124.3 数据 库 设计 


如 上 文 所 述 ， 个 人 博客 最 重要 的 是 内 容 ， 也 就 是 文章 ， 因 此 在 个 人 博客 中 , 文章 数据 表 是 
必 不 可 少 的 。 很 明显 ， 这 个 数据 表 中 必然 需要 的 字段 有 文章 标题 和 文章 内 容 。 

为 了 方便 读者 了 解 作者 发 表 文章 的 信息 ， 可 以 添加 一 个 时 间 字 段 ， 显 示 文 章 发 布 的 时 间 。 

为 了 衡量 一 篇 文章 的 质量 , 添加 一 个 访问 量 字 段 是 一 个 不 错 的 选择 : 读者 可 以 通过 这 个 字 
段 来 衡量 文章 的 质量 ， 作 者 则 可 以 通过 这 个 字段 来 判断 哪些 领域 的 文章 比较 受 欢 迎 。 

因为 在 这 个 项 目 中 需要 通过 登录 才能 发 布 文章 ,所 以 可 以 通过 一 个 作者 字段 来 说 明文 章 的 
发 布 者 。 如 果 博 客 是 由 多 人 或 者 一 个 团队 来 维护 的 ， 那 么 这 个 字段 是 非常 重要 的 。 因 此 ， 文 章 
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数据 表 可 以 设计 为 如 图 12.5 所 示 的 形式 。 


Field Default Extra 
articlelD int auto_increment 
文章 标题 articleTitle varchar 
文章 作者 articleAuthor varchar | | 
文章 内 容 articleContent longtext 
文章 发 布 时 间 articleTime date 


文章 浏览 量 articleClick int 


125 数据 库 文章 数据 表 设 计 


如 上 文 所 述 ， 这 个 博客 项 目 是 需要 通过 登录 才能 发 布 文章 的 ， 整 个 博客 可 以 由 多 人 或 者 一 个 
团队 来 维护 。 因 此 ， 需 要 设计 一 个 作者 表 ， 包 含 作者 姓名 、 作 者 密码 等 字段 ， 如 图 12.6 所 示 。 


Chinese Field Default Extra 


作者 ID authorlD int auto_increment 


作者 姓名 authorName varchar 


作者 密码 authorPassword varchar 


图 12.6 数据 库 作 者 表 设 计 


此 时 , 个 人 博客 项 目的 数据 设计 已 经 完成 。 连 接 MySQL 数据 库 之 后 ， 在 命令 行 中 输入 以 
下 代码 即 可 在 MySQL 中 创建 项 目 所 需 的 数据 库 : 


CREATE: DATABASE TE NOT EXISTS pToq CHARACTER SET üt-ES8; 
USET DIOG; 


CREATE TABLE author ( 

authorID INT KEY AUTO INCREMENT, 
authorName VARCHAR (20) NOT NULL UNIQUE, 
authorPassword VARCHAR (32) NOT NULL 

) 


CREATE TABLE article ( 

articleID INT KEY AUTO INCREMENT, 
articleTitle VARCHAR (100) NOT NULLUNIQUE, 
articleAuthor VARCHAR (20) NOT NULL, 
articleContent LONGTEXT NOT NULL, 
articleTime DATE. NOT NULL, 

arí icliecChiuck TNT DEEAUTT 0 
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1; 


INSERT author VALUES (DEFAULT, 'node', 'el0adc3949ba59abbe56e057f20f883e'!'); 


12.2 项 目 开发 


12.2.1 快速 生成 一 个 项 目 


Express 项 目 可 以 通过 Express 项 目 生 成 器 快速 生成 。 当 然 ， 使 用 Express 项 目 生 成 器 之 前 
需要 从 NPM 中 下 载 安 装 ， 可 使 用 以 下 命令 安装 Express 项 目 生 成 器 : 


npm install -g express-generator 


安装 完成 后 使 用 以 下 命令 生成 一 个 使 用 ejs 模板 的 Express 博客 项 目 : 


express -e blog 


此 时 会 在 使 用 该 命令 的 文件 夹 中 上 自动 创建 一 个 名 为 blog 的 文件 夹 ， 即 项 目 文件 夹 。blog 
文件 夹 的 项 目 目录 如 图 12.7 所 示 。 
| | bin 


| | public 
"u" routes 


[] views 
appjs 
| ] packagejson 


图 12.7 Express 项 目 目录 


在 这 个 项 目 目录 中 ，public 文件 夹 为 静态 资源 文件 夹 ，routes 文件 夹 为 路 由 文件 夹 ，views 
文件 夹 为 ejs 模板 文件 夹 。 
此 时 并 没有 安装 项 目 依 赖 ， 可 以 使 用 以 下 命令 安装 : 


npm install 


接 下 来 看 一 看 appjjs 文件 中 的 内 容 。 其 代码 及 相关 解释 如 下 : 
// 引入 项 目 模块 


var express = require ('express'"'); 

var path = require('path'); 

var favicon = require ('serve-favicon'); 

var logger = require ('morgan'); 

var cookieParser = require ('cookie-parser'); 


var bodyParser = require ('body-parser'); 
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res.locals.message = err.message; 


res.locals.error = req.app.get ('env') === 'development' ? err : {}; 


// 演 染 错误 请 求 页 面 
res: status [(err_statrus"| | 500); 
res.render('error'); 


J); 


module.exports = app; 
在 本 项 目 中 ， 前 端 界面 是 通过 normalize.css 库 来 统一 各 个 浏览 器 默认 样式 的 。 可 以 通过 
NPM 安装 normalize: 


npm install normalize.css 


安装 完成 后 ， 在 node modules 文件 夹 中 找到 normalize.css 文件 来， 将 normalize.css 文件 
移动 到 public 文件 夹 中 的 css 文件 夹 下 ， 以 供 后 续 使 用 。 

同时 在 appjjs 中 添加 以 下 代码 : 
app-listen(3000, function () í 


conseole tog('lrsteninuq port 3000"); 
)); 


这 样 通 过 node app 命令 就 可 以 启动 项 目 了 。 


12.2.2 ”实现 登录 页 面 

登录 界面 的 前 端 页 和 面 仅仅 由 一 个 登录 表单 组 成 ,而 登录 的 核心 思想 是 利用 用 户 提 交 的 用 户 
名 、 密 码 等 信息 与 后 端 数 据 库 中 的 信息 进行 对 比 ， 根据 对 比 结果 给 用 户 反 馈 。 一般 的 情形 是 信 
恩 匹 配 一 致 ， 将 用 户 页 面 重 定 同 至 用 户 需要 进入 的 页 面 ; 各 信息 匹配 不 一 致 ， 则 将 错误 信息 反 
馈 给 用 户 。 

(1) 实现 一 个 前 端 页 面 ， 保 证 用 户 请 求 数据 时 这 个 页 面 是 可 用 的 。 

在 项 目 route 子 文件 夹 下 的 index.js 中 写 入 如 下 内 容 : 

/* 登 录 页 */ 


router.get('/login', function (req, res, next) { 
res.render ('login'); 


H: 
这 里 使 用 到 Express 的 方法 有 : 


@ sel): 定义 一 个 请 求 方法 为 get 方法 的 路 由 ， 第 一 个 参数 是 请 求 的 URL 路 径 。 
© res.render0: 泻 染 一 个 视图 模板 ， 第 一 个 参数 是 模板 引擎 文件 夹 下 的 视图 文件 名 ， 第 
二 个 参数 是 传 给 视图 的 json 数据 。 
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(2) 重 构 这 个 登录 页 面 ， 在 views 文件 夹 下 新 建 一 个 login.ejs 文件 ， 写 入 以 下 内 容 : 


< IDPOCTY PE html> 


<html lang="zh-cn" class="login"> 
<head> 
<meta charset=wUTF-8"> 
<title>Node 的 个 人 博客 </title> 
<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1"> 
<meta name="description" content="Node 的 个 人 博客 ， 分 享 Node . 可 = 技术 ， 不 忘 初 心 ， 共 
同 成 长 "> 
<meta name="keywords" content="Node,Node.js,Node 的 博客 ，Node . js 技术 "> 
<link rel="stylesheet" href="/css/normalize.css"> 
</head> 
<body> 
ee ln 
<Form action "/login” method “POsST”> 
<div class="form-group"> 
<input type="text" name="name" placeholder=" 登 录 名 "> 
</div> 
<div class="form-group"> 
<input type="password" name="password" placeholder=" 密 码 "> 
</div> 
<div class="form-group"> 
< input type "submit" value "ESC UX 
</dix> 
</form> 
</section> 
<footer> 
<p>Copyright © 2018 Node</p> 
<p>Powered by Express</p> 
</footer> 
</body> 
</html> 


(3) 对 这 个 页 面 进行 样式 开发 。 在 public 文件 夹 中 的 css 文件 夹 下 新 建 一 个 main.css 文 
件 ， 作 为 整个 项 目的 样式 文件 。 在 这 个 文件 开头 先 写 入 项 目的 公共 样式 ， 代 码 如 下 : 


a{ 
ECEE decoration: NONE; 
Color. FOOD; 

) 

il Talli 
list-style: none; 


Dacinae z Qz 
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(4) 写 入 以 下 代码 作为 登录 页 面 的 样式 : 
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-login footer{ 
position:absolute; 
bottom: 20px; 
display: biock; 
wel (005; 


(5) 在 login.ejs 文件 中 引入 main.css。 在 login.ejs 的 head 标签 下 添加 以 下 内 容 : 


<link rel="stylesheet" href="/css/normalize.css"> 


<link rel="stylesheet" href="/css/main.css"> 


启动 项 目 ， 在 浏览 器 地 址 栏 中 输入 localhost:3000/login 后 可 以 看 到 登录 页 面 ， 如 图 12.8 
所 示 。 


128 ”登录 页 面 


这 时 ,项目 己 经 可 以 根据 用 户 请 求 登录 页 面 正常 返回 了 。 接 下 来 开发 登录 的 核心 ， 就 是 通 
过 用 户 提 交 的 信息 与 数据 库 中 的 信息 进行 比较 , 从 而 得 出 结果 。 在 项 目的 根 目录 中 新 建 一 个 名 
为 config.js 的 文件 ， 作 为 项 目的 配置 文件 。 这 里 仅 需 要 进行 数据 库 的 配置 ， 可 在 config.js 文件 
中 写 入 以 下 代码 : 
/* 数 据 库 相 应 信息 */ 
const DB = { 

host -TTocathostT; 

pest: 3306; 

user. roota; 

password:"password", 

database:"blog" 
}; 


module.exports = DB; 
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同时 在 根 目录 文件 中 新 建 一 个 名 为 databasejs 的 文件 ， 作 为 mysql 连接 的 文件 。 在 这 个 文 
件 中 写 入 以 下 内 容 : 


const mysql = require ('mysql'); 


const config = require ('./config'); 


/* 连 接 数 据 库 */ 

const database = mysql.createConnection(( 
bost:contig'host; 
user:config.user, 
porticongrglport; 
password:config.password, 
database:config.database 


}) > 
qatabase connect () ; 


module.exports = database; 


这 时 我 们 的 博客 项 目 己 经 连接 好 了 MySQL。 接 下 来 在 用 户 提 交 数 据 的 时 候 与 数据 库 中 的 
数据 进行 对 比 。 在 login.ejs 中 已 经 定义 了 登录 名 和 密码 的 name， 以 及 这 个 登录 表单 提交 的 路 
径 (login) 和 提交 的 方法 (POST) 。 

如 前 文 数据 库 设 计 中 所 述 ， 用 户 的 密码 是 通过 mds 加 密 后 存储 在 MySQL 中 的 ， 所 以 用 
户 提 交 的 数据 同样 需要 通过 mds 加 密 后 才能 对 比 ， 因 此 需要 引入 crypto 模块 。 在 route 文件 夹 
下 的 index.js 中 引入 crypto 和 database.js 模块 : 


var crypto = require ('crypto'); 


var mysql = require('./../database'); 


将 用 户 数据 与 数据 库 信 息 对 比 ， 需 要 在 route 文件 夹 下 的 index js 中 写 入 以 下 内 容 : 
/* 登 录 信息 验证 */ 


router.post('/login', function(req, res, next) { 

var name = req.body.name; 

var password = req.body.password; 

var hash = crypto.createHash ('md5'); 

hash.update (password); 

password = hash.digest ('hex'); 

var query = ”SELECT * FROM author WHERE authorName=" + mysql .escape (name) + " 
AND authorPassword=' + mysql.escape (password); 

mysql.query (query, function(err, rows, fields) { 

TE (rr) f 
console.log (err); 


Feturcn, 
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} 


var user = rows[0]; 
if (user) í 


res.redirect('/'); 


J) 
)); 


这 里 使 用 到 的 重要 方法 是 mysql.escape 0， 可 防止 SQL 注入 攻击 , 对 用 户 提 交 的 数据 进行 


处 理 。 
此 时 ， 启 动 项 目 ， 在 浏览 器 中 输入 localhost:3000/login 后 显示 登录 页 面 ， 再 输入 数据 库 中 预 


先 设 置 好 的 用 户 名 (node) 以 及 密码 (123456) ， 页 面 就 会 自动 跳 转 到 首页 ， 如 图 12.9 所 示 。 


Express 


Welcome to Express 


12.9” 跳 转 至 首页 


这 时 登录 的 功能 虽然 已 经 实现 , 但 是 当 输 入 密码 和 用 户 名 后 , 浏览 器 没 有 任何 反应 ,对 用 
户 来 说 显然 是 非常 不 友好 的 。 因 此 需要 增加 对 密码 或 者 用 户 名 输入 错误 的 处 理 。 在 这 里 ,需要 
在 用 户 名 或 者 密码 错误 时 给 用 户 提醒 。 修 改 登录 的 post 方法 请 求 的 处 理 ， 代 码 如 下 : 


/* 登 录 信 息 验 证 */ 
router.post ('7/loqin", function(regq, res, next) 1 
var name = req.body.name; 
var password = req.body.password; 
var hash = crypto.createHash ('md5'); 
hash.update (password); 
password = hash.digest ( 'hex'); 
var query = "SELECT * FROM author WHERE authorName=" + mysql.escape (name) + " 
AND authorPassword Tr mysg! -escape (password) r 
mysql.query (query, function(err, rows, fields) { 
jP (STrr) f 
console.log (err); 
SeEeUT ny 
} 
var user = rows[0]; 


if (!user) { 
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res.render('login', (message: ' FA 2 nka 3 RU £B Tx ' Ho 
Ee 

} 

req.session.userSign = true; 

req.session.userID = user.authorID; 
res redirect ("/"); 

}); 
}); 


在 login.ejs 文件 中 增加 错误 信息 的 显示 。 修 改 密码 的 div 元 素 为 以 下 内 容 : 


<div Class- Sirorm qrou > 
<input type="password" name="password" placeholder=" 密 码 "> 
<%if (message) {%> 
<p> <%= message%> </p> 
E s> 


</div> 

因为 密码 或 者 用 户 名 错误 时 演 染 的 模板 和 get 请 求 泻 染 的 模板 是 同一 个 模板 , 所 以 也 需要 
给 get 请 求 添加 一 个 json 数据 ， 将 get 请 求 的 处 理 函 数 修改 为 如 下 内 容 : 
router.get('/login', function (req, res, next) { 


res.render('login', (Imessage:'']); 


Ji; 


重新 局 动 项 目 ， 可 以 发 现 当 密码 或 者 用 户 名 错误 时 ， 已 经 有 了 对 用 户 友好 的 提醒 ， 如 图 
12.10 所 示 。 


12.10 ”提示 用 户 名 或 者 密码 错误 
博客 项 目的 登录 页 面 束 完成 了 。 


1223 ”实现 博客 首页 
上 文中 登录 博客 后 自动 跳 转 至 首页 , 接 下 来 实现 博客 的 首页 。 博客 首页 是 任何 用 户 都 可 以 
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访问 的 ， 所 以 不 需要 做 权限 设置 。 
在 route 文件 夹 下 的 index.js 文件 中 将 首页 的 get 请 求 处 理 改 为 如 下 代码 : 


/* 首 页 */ 
router.get('/', function(req, res, next) [Í 
var query = 'SELECT * FROM article'; 


mysql.query (query, function(err, rows, fields)t 
var articles = rows; 


res.render("index", (articles: articles}); 


在 views 文件 夹 下 的 index.ejs 文件 中 写 入 以 下 代码 : 


< IDOCTYPE htmi> 
Shemi Plang zh er > 
<head> 
<head> 
<meta charset="UTF-8"> 
<title>Node 的 个 人 博客 </title> 
me C Ti L Lp eq xX UA Comatible content rE Edge chrome- TE> 
<meta name="description" content="Node 的 个 人 博客 ， 分 享 Node . Ss EAR, DEUG, Jk 
同 成 长 "> 
<meta name="keywords" content="Node,Node.js,Node 的 博客 ，Node .js 技术 "> 
<link rel="stylesheet" href="/css/normalize.css"> 
<link rel="stylesheet" href="/css/main.css"> 
</head> 
</head> 
<body> 
<header> 
<h1>Node 的 个 人 博客 </h1> 
</header> 
“Sec i Tor e ass-— mn > 
二 
<section class="main-aside-avatar"> 
<img src="img/avatar.jpg" alt=""> 
Te re 
<ul> 
<li><a href=""> #5 X ğ</a></li> 
<li><a href=""> 关 于 博客 </a></1i> 
<li><a href=""> 友 情 链接 </a></1i> 
zgliszcza pret===> 和 全 出 同 客 </a></i> 
ul> 


Z asice> 
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此 时 ， 首 页 基本 可 以 看 了 。 为 了 用 户 体验 更 好 ， 接 下 来 要 进行 样式 的 开发 。 
在 main.css 文件 中 继续 写 入 以 下 内 容 : 
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font-size: 24px; 


line-height: 40px; 

} 

.main-articles-items-des span{ 
padding right: gr; 
color:T1333; 


tont size:  T4px; 


EAMH, EARP LESARAR, WE 12.11 所 示 。 


Node 的 个 人 博客 
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12.11 博客 首页 


此 时 数据 库 中 并 没有 文章 , 因此 博客 的 首页 也 就 没有 显示 任何 文章 。 可 以 通过 命令 行 直 接 
向 MySQL 数据 库 中 手动 添加 几 条 记录 来 验证 一 下 效果 。 连 接 好 MySQL 后 在 命令 行 中 输入 以 
下 命令 ， 向 MySQL 中 添加 几 篇 文章 : 

INSERT article SET articleTitle="Node.js 基础 知识 


",articleAuthor="node",articleContent="Node. jJ 


基础 知识 简要 介绍 ", articleTime=CURDATE () ; 


INSERT article SET articleTitle="Node.js 进 阶 知识 
",articleAuthor="node",articleContent="Node .js 进 阶 知识 简要 介绍 
" articleTime=CURDAT E () ; 


INSERT article SET articleTitle="Node.js 高 级 知识 
",articleAuthor="node",articleContent="Node.js 高 级 知识 简要 介绍 
"7articleTime=CURDATE () ; 


这 时 ， 刷 新 浏览 器 可 以 看 到 三 篇 文章 的 标题 已 经 出 现在 了 项 目 首页 ， 如 图 12.12 所 示 。 
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Node 的 个 人 博客 


Node,js 基 础 知识 


作者 ; node #718] ; Fri Jan 27 2018 00:00:00 GMT+0800 (中 国 灶 准时 | 问 ) WET :; O 


Node.js 进 阶 知识 


ET ; node 发 布 3j 间 : Fri Jan 27 2018 00:00:00 GMT+0300 (中 国标 准时 间 ) rz : 0 


Node.js 高 级 知识 


FES ; node #ZTGE3[B] : Fri Jan 27 2018 00:00:00 GMT+0800 (FARERI WAE : 0 


Capyright © 2018 Node 
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1212 ” 带 有 数据 的 博客 首页 


这 时 ,首页 文章 的 发 布 时 间 是 国际 时 间 ， 既 在 排版 上 影响 了 整个 页 面 的 美观 ， 也 不 利于 辩 
识 时 间 ， 因 此 需要 在 传递 给 视图 之 前 将 这 个 时 间 处 理 一 下 ,将 首页 的 get 请 求 处 理 修改 为 以 下 
代码 : 


router.get('/', function(req, res, next) Í 
var query = "SELECT * FROM article'; 
mysql.query (query, function(err, rows, fields) { 
var articles = rows; 
articles.forEach (function(ele) { 
var year = ele.articleTime.getFullYear(); 
var month = ele.articleTime.getMonth() + 1 > 10 ? 
ele.articleTime.getMonth() : '0' + (ele.articleTime.getMonth() + 1); 
var date = ele.articleTime.getDate() > 10 ? ele.articleTime.getDate () : 
'O' + ele.articleTime.qetDate () ; 
ele.articleTime = year + '-'! + month + '-' + date; 


J); 


res.render ("index", (articles: articles}); 


|); 
重新 局 动 项 目 ， 可 以 在 浏览 器 中 看 到 文章 的 时 间 已 经 符合 预期 了 了 ， 如 图 12.13 所 示 。 


Node 的 个 人 博客 


Node.js 基 础 知识 


作者 : node 发 在 时 间 : 2018-01-27 IER : 0 


Node.js 进 阶 知 识 


作者 : node #728) : 2018-01-27 HAE : 0 


Node.js 高 级 知识 


YE : node 友 布 时 间 : 2018-01-27 HES : 0 


Copyright © 2018 Node 
Powered by Espress 


1213 ”时间 格 式 修改 后 的 博客 首页 
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这 时 给 鼠标 移入 文章 添加 一 些 简 单 的 特效 , 优化 一 下 用 户 体 验 , 在 main.css 中 添加 以 下 代 
h: 


@keyframes move { 
fromt{ 
transform:translate (Opx, 0); 


) 
tol 


transform:translate (50px, 0); 


) 
.main-articles-item:hover{ 
animation:move 1.8s; 


animation-fill-mode: forwards; 


XEHE, A A BJB 3 AER £ nl EHARA, EAN R tg k a 1 1, 
几乎 每 个 页 面 都 会 用 到 ， 前 端 页 面 的 head 标签 内 容 也 是 完全 一 致 的 ， 这 些 内 容 在 之 后 的 博客 
页 面 依旧 会 用 到 ， 因 此 可 以 将 这 些 东 西 分 离 出 来 重用 。 

在 views 文件 夹 下 新 建 一 个 名 为 public 的 文件 夹 ， 在 这 个 文件 夹 中 分 别 新 建 head.ejs、 
header.ejs、footer.ejs、aside.ejs 文件 ， 在 head.ejs 中 写 入 head 标签 的 内 容 ， 即 将 以 下 代码 写 入 
这 个 文件 : 


<head> 

e a fch ar ser ppp 9> 

<title>Node 的 个 人 博客 </title> 

<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1"> 

<meta name="description" content="Node 的 个 人 博客 ， 分 享 Node.js 技术 ， 不 忘 初 心 ， 共 
同 成 长 "> 

<meta name="keywords" content="Node,Node.js,Node 的 博客 ，Node . js 技术 "> 

<link rel="stylesheet" href="/css/normalize.css"> 

<link rel="stylesheet" href="/css/main.css"> 


<head> 


TE header.ejs 文件 中 写 入 博客 网 站 的 头 部 ， 即 将 以 下 代码 写 入 header.ejs 文件 : 


<header> 
<hl>Node 的 个 人 博客 </h1> 


</header> 


在 footer.ejs 文件 中 写 入 博客 网 站 的 尾部 ， 即 将 以 下 代码 写 入 footer.ejs 文件 : 


<footer> 
<p>Copyright © 2018 Node</p> 


<p>Powered by Express</p> 
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< Footer> 


在 aside.ejs 文件 中 写 入 博客 网 站 的 侧 边栏 ， 即 将 以 下 代码 写 入 aside.ejs 文件 : 


<aside> 

“SecElionelass mm aside avatara: 
<img src="img/avatar.jpg" alt=""> 

LA Sections 

<ul> 
<li><a href=""> 撰 写 文章 </a></1i> 
<li><a href=""> 关 于 博客 </a></1i> 
<li><a href=""> 友 情 链 接 </a></1i> 
<li><a href=""> 登 出 博客 </a></1i> 

< ul> 


</aside> 


利用 ejs 的 include 方法 可 以 将 外 部 的 ejs 文件 引入 ， 引 入 的 方法 如 下 : 
<%— include (文件 路 径 ) $> 


可 以 通过 这 种 方式 将 这 些 文件 引入 login.ejs 文件 和 index.ejs 文件 , 修改 后 的 login.ejs 文件 
内 容 如 下 : 
< IpDOCTYPE html> 
<html lang="zh-cn" class="login"> 
<%— include ("./public/head.ejs")$%> 
<body> 
— sec i TOT > 
<form action="/7login" method="posTw> 
<div class="form-group"> 
<input type="text™ name="name" placeholder=" 登 录 名 "> 
< / div> 
<div class="form-group"> 
<input type="password" name="password" plLlaceholder=" 密 码 "> 
<%$if (message) {%> 
<p> <%= message%> </p> 
< 
</div> 
<div class="form-group"> 
<input type="submit" value=" #7} "> 
</div> 
< oru 
Seri i 
<%— include ("./public/footer.ejs")%> 
</body> 
</html> 
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修改 后 的 index.ejs 文件 内 容 如 下 : 


<IDOGTEYPE html> 


<html lang="zh-cn"> 


<head> 
<%- include("./public/head.ejs")%> 
</head> 
<body> 
<%— include ("./public/header.ejs")%> 
Sec pore ass muna > 
<%- include ("./public/aside.ejs")%> 
<sēction Class- main articles > 
<ul> 
<% for(var i = 0, max = articles.length; i < max; TIT) {3> 
puc lass mar art ic kes A FEME 
<h2><a hret wú="w=>< — artieleslil aarticleTille ></a></h2> 
<section class="main-articles-items-des"> 
<p><span> 作 者 : <%= articles[i] .articleAuthor %></span><span> 发 布 时 间 : <%= 
articles[i] .articleTime %></span><span> 浏 览 量 : <%= 
articles[i] .articleClick %></span></p> 
</secuion> 
< li> 
< 
<ul> 
— / SECCIONS 
< Sect ion> 
<%— include ("./public/footer.ejs")%> 
</body> 
</html> 


12.24 ”博客 文章 内 容 页 的 实现 


每 篇 文章 都 有 一 个 内 容 页 ， 当 一 个 博客 的 文章 量 很 大 时 , 不 可 能 为 每 篇 文章 的 内 容 都 单独 
设计 一 个 路 由 。Express 提供 了 一 种 路 由 配置 方式 ， 在 路 由 路 径 中 使 用 一 个 占 位 符 ， 通 过 这 个 
占 位 符 来 判断 不 同 的 路 由 。 这 个 博客 项 目 中 ， 每 篇 文章 的 ID 是 不 同 的 ， 因 此 很 适合 作为 占 位 
符 ， 在 route 文件 夹 下 的 index js 文件 中 添加 以 下 代码 : 

/* 文 章 内 容 页 */ 


router.get ('/articles/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
var query = "SELECT * FROM article WHERE articleID=' + mysql.escape (articleID);/ 
mysql.query (query, function(err, rows, fields) { 
if(err) í 


console.log (err); 
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EeEurmn 

} 

var article = rows[0]; 

var year = article.articleTime.getFullYear(); 

var month = article.articleTime.getMonth() + 1 > 10 ? article.articleTime. 
getMonth() : "0' + (article.articleTime.getMonth() + 1); 

var date = article.articleTime.getDate() > 10 ? article.articleTime. 
getDate(): '0' + article.articleTime.getDate () ; 

article articleTime Vear t ! F month t ! "radates 


res.render('article', {article:article}); 


这 里 使 用 到 的 重要 方法 有 req.params。 这 个 对 象 存储 着 请 求 时 路 由 配置 中 占 位 符 的 真实 内 
容 ， 占 位 从 使 用 “: ”开头 表示 ， 这 里 使 用 的 是 每 遍 文 章 的 ID。 

文章 内 容 的 路 由 配置 完成 后 , 接 下 来 就 是 视图 模板 的 开发 了 。 在 views 文件 夹 下 新 建 一 个 
名 为 article.ejs 的 文件 ， 在 这 个 文件 中 写 入 以 下 代码 : 


= I pOC'TY PE TP tri > 
<html lang="zh-cn"> 
<head> 
<%- include ("./public/head.ejs")$%> 
</head> 
<body> 
<%— include ("./public/header.ejs")%> 
<SecClElon CISS SMA. E LOACETK > 
<%- include ("./public/aside.ejs")%> 
<section class= "main articles articles"> 
<section class="main-articles-tLtitle"> 
<h2> <%=article.articleTitle%> </h2> 
<p> 
<span> 作 者 : <%=article.articleAuthor%></ span><span> 发 布 时 间 : 
<%=article.articleTime%></span><span> 浏 览 量 ; <%=article.articleClick%></span> 
< D> 
</section> 
-ectann elass main art Te es cormier > 
<p><%=article.articleContent%></p> 
< Section 
</section> 
ET 
</Section> 
<%— include("./public/footer.ejs")%> 
</body> 
</html> 
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接 下 来 需要 为 文章 内 容 页 添加 样式 ， 在 main.css 文件 中 继续 写 入 以 下 代码 : 


section.articlest 


border: lpx solid #c0c0c0; 
min height: 46S5px; 
padding: 0T TE5pX; 

} 

.main-articles-title{ 
border bottom: lpx solid FecOCc0Oc0O; 

} 

-main articles- ticle h2i 
text-align: center; 

} 

-main articles- -title pi 
Font size: l4pz; 
text-align: center; 

} 

main-articles-title p span{ 
padding: TO 

I 

-main-articles-content pt 
Pest TmoenEe F> em; 
FONE- SIZE: 16px; 


line-height: 1.8em; 


此 时 , 重新 启动 项 目 , EA es PAE ha ANAR URL, 即 localhost:3000/articles/1, 
可 以 看 到 内 容 页 已 经 出 现在 浏览 器 中 了 ， 如 图 12.14 所 示 。 


Node 的 个 人 博客 


Node.js 基 础 知识 


EE ; node ”发 布 轩 | 名 :2018-01-27 MRE: D 


Nodejs 其 广 知识 简 亚 介 抬 


Copyright © 2018 Node 
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12.14 文章 内 容 页 
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此 时 ， 文 章 内 容 页 已 经 可 以 通过 URL 访问 了 。 当 然 ， 对 于 一 个 整体 来 说 ， 还 需要 在 首页 
中 添加 文章 的 URL， 以 方便 访问 者 可 以 通过 单 击 首页 的 链接 直接 访问 文章 内 容 。 在 index.ejs 
中 添加 文章 内 容 页 的 URL， 具 体 如 下 : 


<h2><a href- T /articles/<3$= aarticles[lil articlern$>"><3= 


articles|i]-articileTitle S></a></h2> 


此 时 , 通过 浏览 器 访问 博客 首页 后 ,可 以 发 现 已 经 可 以 直接 通过 单 击 跳 转 至 文章 内 容 页 了 。 
还 需要 解决 的 问题 是 当 用 户 访 问 文章 内 容 页 时 , 需要 增加 点 击 量 , 只 需要 对 这 篇 文章 的 所 
击 量 加 一 即 可 ， 对 文章 内 容 页 的 路 由 处 理 修改 为 以 下 代码 : 


router.get ('/articles/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
var query = "SELECT * FROM article WHERE articleID=' + mysql.escape (articleID); 
mysql.query (query, function(err, rows, fields) ( 
jf (err) 1 
console.log (err); 
Fe Ent cri; 
) 
var query = 'UPDATE article SET articleClick=articleClick+1 WHERE articleID=' 
+ mysql.escape (articleID); 
var article = rows[0]; 
mysql.query (query, function(err, rows, fields) ( 
Ji (err) `i 
console.log(err) 


return; 


var year = article.articleTime.getFullYear(); 

var month = article.articleTime.getMonth() + 1 > 10 ? 
article.articleTime-getMonth() :` 10! + (article.articleTime.getMonth(y T 1); 

var date = article.articleTime.getDate() > 10 ? 
article.articleTime.getDate() : 'O' + article.articleTime.getDate () ; 

article.articleTime = year + '-' + month + '-' + date; 


res.render('article', (article:article)); 


)); 
)); 


这 时 通过 刷新 浏览 器 可 以 发 现 每 篇 文章 的 浏览 量 都 增加 了 。 这 个 浏览 量 可 以 通过 内 容 页 和 
首页 体现 ， 如 图 12.15 和 图 12.16 所 示 。 
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Node 的 个 人 博客 


Node-js 进 阶 知 识 


{ES : node ”发 万 可 问 : 2018-01-27 PAE : 18 


Nodejs 进 纹 和 DiR 简 受 介 后 
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12.15 浏览 量 增 加 的 文章 内 容 页 


Node 的 个 人 博客 


Node.js 基 础 知识 


{ES : node 发 布 时 间 : 2018-01-27 WAF : 20 


Node.jjs 进 阶 知识 


作者 : node 发 布 时 间 : 2018-01-27 WAF : 18 


Node.js 高 级 知识 


作者 : node 上 发布 时 间 : 2018-01-27 WAR : 46 
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图 12.16 浏览 量 增 加 的 首页 


12.2.5 博客 文章 发 布 的 实现 


在 前 文中 项 目 已 经 通过 直接 向 MySQL 中 插入 文章 数据 来 坦 看 博客 首页 的 效果 和 文章 内 
容 页 的 效果 ， 这 里 将 直接 实现 文章 在 网 页 发 布 的 功能 。 

文章 发 布 的 页 面 和 登录 页 面 非 第 类似， 页 面 中 只 有 一 个 表单 ， 在 index js 文件 中 添加 对 这 
个 页 面 的 路 由 处 理 ， 代 码 如 下 : 


/* 写 文章 页 面 */ 
router.get('/edit', function(req, res, next) { 
res.render('edit'); 


}); 
接 下 来 实现 这 个 页 面 的 视图 层 ， 在 views 文件 夹 中 新 建 一 个 名 为 edit.ejs 的 文件 ， 将 以 下 
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代码 写 入 这 个 文件 中 : 


接 下 来 就 是 样式 的 实现 ， 将 以 下 代码 添加 到 main.css 文件 中 : 
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CHESGE pointer; 

} 

Form rou rnp 
height: 24px; 

} 

.text-group textareal 
herghti :350Dpx; 

) 

.text-group label{ 
yertical align: top; 


} 


重新 局 动 项 目 ， 在 浏览 器 中 输入 localhost:3000/edit 这 个 URL， 可 以 在 浏览 器 中 看 到 文章 
发 布 页 面 ， 如 图 12.17 所 示 。 


Node 的 个 人 博客 
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图 12.17 文章 发 布 页 面 


此 时 和 登录 页 面 一 样 ， 在 用 户 提交 数据 后 需要 操作 数据 库 。 这 里 需要 将 这 些 数 据 添 加 至 
MySQL 数据 库 。 在 这 之 前 还 需要 解决 一 个 问题 ， 就 是 如 何 能 够 识别 当前 登录 的 用 户 ， 从 而 将 
这 个 用 户 的 姓名 存储 到 数据 库 中 。 这 就 涉及 cookie 和 session 了 。 下 面 简要 说 明 一 下 cookie 和 
session, 

cookie 和 session 都 是 基于 服务 器 的 ，cookie 存储 在 浏览 器 客户 问 ， 而 session 存储 在 服务 
器 问 。 用 户 浏 览 网 站 时 ， 会 在 浏览 器 客户 端 存储 一 些 有 关 用 户 信 息 的 内 容 ， 这 些 便 是 cookie. 
当 用 户 再 次 访问 相同 的 网 站 时 ， 服 务 器 通过 检查 客户 端的 cookie 数据 而 返回 相应 的 内 容 。 
cookie 显然 是 通过 客户 端 来 保持 状态 的 ， 而 session 则 是 通过 服务 器 端 来 保持 状态 的 。 

session 数据 存储 在 服务 器 端 ， 当 用 户 访问 相同 网 站 的 时 候 ， 服 务 器 端 首先 检查 这 个 网 页 
请 求 中 是 否 含有 一 个 session 的 标识 , 在 有 则 在 服务 器 端 得 找 是 否 有 相应 的 session 数据 以 及 这 
个 数据 是 否 过 期 ， 服 务 器 根据 结果 返回 相应 的 内 容 。 一 般 来 说 ， 这 个 session 标识 可 以 称 为 
session id， 这 个 session id 必须 是 不 易 发 现 规律 的 字符 串 ， 以 防止 被 其 他 用 户 盗 取 。 

一 般 来 说 , 不 重要 、 不 敏感 的 信息 可 以 使 用 cookie 存储 , 重要、 敏感 的 信息 应 该 使 用 session 
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存储 ， 因 为 cookie 容易 被 网 站 攻击 者 盗 取 。 
使 用 express-session 模块 前 需要 通过 NPM 安装 : 


npm install express-session -dev-save 


安装 express-session 模块 之 后 在 app.Js 文件 中 引入 : 


var session = require ('express-session'); 


引入 express-session 模块 之 后 添加 以 下 代码 使 用 这 个 模块 : 
/* 应 用 的 session 配置 */ 


app.use (session ( ( 
SeEGEe rplodq'; 
cookie: {maxAge:1000*60*24*30}, 
resave: false, 


saveUninitialized: true 


Hi: 


# m A 4 BJ KHA WE, M EHP RKR H AE EAE] session 中 。 
在 index.js 中 的 登录 路 由 post 请 求 中 得 询 完 用 户 信息 后 ， 将 用 户 信 息 添 加 到 session H, ARA 
如 下 : 


req.session.user = user; 
此 时 ， 登 录 post 请 求 的 处 理 代码 如 下 : 
/* 登 录 通 过 session 验证 */ 


router.post(*/loqin", Ffunction[ (req, res, next) | 
var name = req.body.name; 
var password = req.body.password; 
var hash = crypto.createHash ('md5'); 
hash.update (password); 
password = hash.digest ( 'hex'); 
var query = 'SELECT * FROM author WHERE authorName=' + mysql.escape (name) 十 " 
AND authorPassword=' + mysql.escape (password); 
mysql.query (query, function(err, rows, fields) { 
Tit (err) l 
console.log (err); 
EE 
} 
war user -I TOWSON; 
if (!user) í 
res.render('login', (message: ' 用 户 名 或 者 密码 错误 '}); 
return, 
} 


req.session.user = USEE; 


249 


Node.js 10 实战 


res-redirect('/'):; 
}); 
)); 


此 时 ， 用 户 登 录 后 ， 用 户 的 信息 就 会 存储 在 session 中 。 当 用 户 发 布 文章 时 ， 将 这 些 信息 
提取 出 来 就 可 以 了 。 
在 index.js 中 添加 用 户 发 布 文章 的 post 请 求 处 理 ， 将 以 下 代码 添加 到 index.js 文件 中 : 


router.post("'/edit', function (req, res, next). 1{ 
var title = req.body.title; 
var content = req.body.content; 
var author = req-session-user.authorName; 
var query = " INSERT article SET articleTitle=" + mysql.escape (title) + 
',articleAuthor=' + mysql.escape (author) + ',articleContent=' + 
mysql.escape (content) + ',articleTime=CURDATE () ' ; 
mysql.query (query, function(err, rows, fields) { 
if(err) { 
console.log (err); 
ERUEN 
} 
res.redirect('/'); 
Fis 
)); 


重新 启动 项 目 ， 登 录 博 客 后 添加 文章 并 保存 ， 可 以 在 博客 项 目的 首页 看 到 保存 的 文章 , 单 
击 就 可 以 看 到 文章 的 内 容 了 人， 如 图 12.18 和 图 12.19 所 示 。 


Node 的 个 人 博客 


Node.js 基 础 知识 


TES : node 发 布 时 间 : 2018-01-27 WES : 2 


Nodejjs 进 阶 知识 


TES : node 发 布 时 间 : 2018-01-27 W32 : 


Node.js 高 级 知识 


TES : node 发 布 时 间 : 2018-01-27 WEZ 


Node 


TES : node 发 布 时 间 : 2018-01-28 WEE : ( 


Node.js REE 


TES : node #ARjiE) : 2018-01-28 WEE : 4 
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图 12.18 添加 文章 后 的 博客 首页 
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Node 的 个 人 博客 


Node.js RRE 


YES : node ”发布 时 间 : 2018-01-28 WAF: 4 


殖 若 越 来 越 记 的 开发 老 字 习 和 使 用 Nodejs ,Nodejs 技 让 会 专 到 更 匈 人 的 关注 。 
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图 12.19 ”添加 的 文章 内 容 页 


此 时 , 用 户 已 经 可 以 通过 博客 项 目 来 添加 文章 了 , 但 是 现在 这 个 项 目 中 存在 两 个 明显 的 问 
题 : 一 是 用 户 添加 的 文章 是 出 现在 博客 首页 的 文章 列表 最 后 的 , 良好 的 用 户 体验 应 该 是 让 最 近 
发 布 的 文章 出 现在 首页 文章 列表 的 最 前 方 ; 二 是 用 户 没 有 登录 也 可 以 访问 发 布 文章 这 个 页 面 ， 
此 时 单 击 “ 保 存 ” 会 引起 错误 ， 因 为 并 不 能 从 session 中 提取 登录 用 户 的 信息 。 

第 一 个 问题 通过 改变 首页 选取 数据 库 记 录 的 SQL 语句 就 可 以 解决 。 将 SQL 语句 改 为 以 下 
代码 : 


var query = "SELECT * EROM article ORDER BY articleTD DESCI; 


重新 局 动 项 目 ， 在 浏览 器 中 访问 项 目 首页 ， 可 以 看 到 文章 倒序 出 现在 首页 中 ， 如 图 12.20 
所 示 。 


Node 的 个 人 博客 


Nodejjs 技 术 展望 


ŽS : node 发 布 时 间 : 2018-01-28 浏览 虽 : 5 


Node 


YES : node 点 布 时 间 : 2018-01-28 MWEE : 0 


Node.js 高 级 知识 


ZE : node 发 布 时 间 : 2018-01-27 WAS : 46 


NodejJs 进 阶 知识 


YES : node 发 布 时 间 : 2018-01-27 WBE : 19 


Nodejs 基 础 知识 


=ë : node 发布 时 间 : 2018-01-27 W48 : 20 
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12.20 ”文章 倒序 排列 的 博客 首页 
第 二 个 问题 只 要 在 用 户 访 问 文章 发 布 页 面 的 时 候 做 一 个 判断 ， 判 断 session 中 是 否 存 在 用 
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户 信息 ,不 存在 就 将 页 面 重 定向 至 登录 页 面 。 将 访问 文章 发 布 页 面 的 路 由 处 理 修 改 为 以 下 代码 : 


router.get('/edit', function(req, res, next) { 


var user = req.session.user; 
TEI user) mi 
res.redirect('/login'); 
Ten 
} 
res.render('edit'); 


J); 


重新 局 动 项 目 , 在 用 户 没 有 登录 的 情况 下 访问 文章 友 布 页 面 , 可 以 发 现 页 面 被 重 定 问 至 登 
录 界 面 ， 用 户 登 录 之 后 就 可 以 访问 发 布 文 章 的 页 面 。 

最 后 将 文章 页面 的 URL A aside.ejs 文件 中 ， 束 可 以 通过 单 击 来 直接 访问 这 个 友 布 
页 面 了 : 


<aside> 

SectElnonnelass alm aside Avatari 
<img src="/imq/avatar.jpg" alt=""> 

</section> 

<ul> 
<li><a href="/edit"> 撰 写 文章 </a></1i> 
<li><a href=""> 关 于 博客 </a></1i> 
<li><a href=""> 友 情 链 接 </a></1i> 
<li><a href=""> 登 出 博客 </a></1i> 

</ul> 


— == (G => 


此 时 文章 发 布 的 功能 就 实现 了 。 


1226 博客 友情 链接 的 实现 


此 时 博客 项 目 己 有 雏形 , 具备 基本 的 文章 发 布 和 文章 查看 功能 。 为 了 让 整个 项 目 看 起 来 更 
加 完整 ， 这 里 添加 一 个 友情 链接 的 页 面 。 这 个 项 目 中 友情 链接 页 面 是 一 个 静态 页 面 。 

在 route 文件 夹 下 的 index.js 文件 中 添加 以 下 代码 : 
router.get('/friends', function (req, res, next) 

res.render('friends'); 


jh; 
在 views 文件 夹 下 新 建 一 个 名 为 friends .ejs 的 视图 模板 ， 写 入 以 下 内 容 : 


< IDOCTYPE html> 
<html lang="zh-—cn"> 
<head> 


<%- include ("./public/head.ejs")%> 
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</head> 
<body> 
<%— include ("./public/header.ejs")%> 
<section class= main Floatfix > 
<%- include ("./public/aside.ejs")%> 
SSECETONIClASS S main AneElcles riends > 
<h2>Node 的 友情 链接 网 站 </h2> 
<l  class="rloatF+Fix"T> 
<li><a href="https://github.com">GitHub</a></li> 
<li><a href="https://cnodejs.org/">CNode</a></li> 
<li><a href="https://segmentfault.com/">SegmentFault</a></li> 
<li><a href="https://google.com">Google</a></li> 
<li><a href="https://www.npmjs.com">NPM</a></li> 
<li><a href="https://ruby-china.org/">Ruby China</a></li> 
<li><a href="http://www.w3school.com.cn">W3CSchool</a></1i> 
<li><a href="https://developer.mozilla.org">MDN</a></li> 
</ul> 
<A sect ion? 
</section> 
<%— include ("./public/footer.ejs")$%> 
</body> 
</html> 


在 main.css 文件 中 写 入 以 下 代码 作为 这 个 页 面 的 样式 : 


-friends h2{ 
text-align:center; 
} 
friends li{ 
float:left? 
Wa th 25%; 
height -:30px; 
line-height:30px; 
) 
“Friendsriiiralhoveri 


color: FI83pDS8ErT 


重新 局 动 项 目 ， 可 以 在 浏览 费 中 看 到 友情 链接 页 面 ， 如 图 12.21 所 示 。 
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Node 的 个 人 博客 


Node 的 友情 链接 网 站 


segmentFault 
W3CSchool 
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图 12.21 友情 链接 页 面 
此 时 ， 一 个 静态 的 友情 链接 页 面 已 经 构建 完成 。 


12.2.7 关于 博客 页 面 的 实现 


关于 博客 页 面 和 友情 链接 页 面 类 似 ， 也 是 一 个 静态 页 面 。 
在 route 文件 夹 下 的 index js 文件 中 添加 以 下 代码 : 


router.get ('/about', function(req, res, next) { 


res render ("abort tp; 


}); 
在 views 文件 夹 下 新 建 一 个 名 为 about.ejs 的 视图 模板 ， 写 入 以 下 内 容 : 


< LDOCTY PE heml> 
<hnemb lang Zh en > 
pea 
<%— include ("./public/head.ejs")%> 
</head> 
<body> 
<%— include ("./public/header.ejs")%> 
-Sectelon elass mn E Doz t P px > 
<%— include ("./public/aside.ejs")%> 
<SECEION olass man artschiesrasbontu> 
<h2> 关 于 博客 </h2> 
<p> 本 博客 主要 分 享 Node .js 和 前 端 技术 ， 和 希望 和 大 家 共同 成 长 。</Pp> 
A E POTI 
< Section> 
<%— include ("./public/footer.ejs")%> 
</body> 
</html> 
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在 main.css 文件 中 写 入 以 下 代码 作为 这 个 页 面 的 样式 : 


sealant n2 


text-align: center; 


) 
"abort pi 


text-indent: 2em; 


午 新 局 动 项 目 ， 可 以 在 浏览 上 费 中 看 到 关于 博客 页 面 ， 如 图 12.22 所 示 。 


Node 的 个 人 博客 


关于 博客 


本 博 宪 主要 分 享 Node.js 和 前 端 丢 术 ,关切 和 大 永 共同 成 长 。 
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12.2.8 博客 404 页 面 的 实现 


404 页 面 依旧 是 一 个 静态 页 面 ， 在 所 有 路 由 都 没有 匹配 到 的 情况 下 就 作为 404 处 理 。 
将 app.js 文件 中 原来 对 404 页 面 的 处 理 修改 为 如 下 代码 : 


app.use (function (req, res, next) { 
res.render('404'!'); 


}); 
在 views 文件 夹 中 新 建 一 个 名 为 404.ejs 的 视图 文件 ， 添 加 以 下 代码 : 


<! DOC'TIYPE html> 
<html lang="zh-cn" class="not-found"> 
<head> 

<%- include ("./public/head.ejs")%> 
</head> 
<body> 
<h2>404, 你 来 到 了 没有 信息 的 沙漠 </h2> 
</body> 
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<html> 


在 main.css 中 添加 以 下 代码 作为 404 页 面 的 样式 : 


moe Foungd Not Eound bool 
height:100%; 
WICEN: TOOR; 

} 

- mot found bodyi 
background-image: url("../img/404.jpg"); 
Þackground size: T1005 1003; 
background-repeat: no-repeat; 

) 

-NOC Cound N2i 
text-align: center; 
font-size:24px; 
position:absolute; 

WAEN TOURS 
color:{FEFE; 


s 


重新 启动 项 目 ， 在 浏览 器 中 输入 一 个 404 的 URL, 4n localhost:3000/aaaa， 可 以 看 到 404 
页 和 面 已 经 呈现 ， 如 图 12.23 所 示 。 


404., 你 来 到 了 没有 信息 的 沙漠 


12.23 项 目 404 页 面 


12.2.9 博客 侧 边 栏 的 优化 


整个 博客 项 目 基本 成 形 , 但 是 目前 并 不 能 通过 侧 边 栏 来 跳 转 到 各 个 页 面 , 需要 优化 一 下 侧 
本 项 目 设 定 ， 当 用 户 已 登录 博客 时 , 侧 边 栏 中 显示 “ 登 出 博客 ”; 当 用 户 没 有 登录 博客 时 ， 
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侧 边栏 中 显示 “登录 博客 ”。 
将 aside.ejs 文件 修改 为 以 下 代码 : 


cacen 

<section class="main-aside-avatar"> 
<img src="/img/avatar.jpg" alt=""> 

</section> 

<ul> 
lisa hrei "MRE icali 
lia hrei "fabout > ATMA Jacl 
<li><a href="friends"> 友 情 链接 </a></1i> 
<li><a href="/edit"> 撰 写 文 章 </a></1i> 
<li><a href "/login ARAA /a/li> 

<in 


= =s == 


重新 局 动 项目 ， 可 以 发 现 博客 已 经 可 以 通过 侧 边栏 来 实现 各 个 页 面 的 跳 转 了 。 


判断 用 户 是 否 登录 ， 只 需要 判断 用 户 是 否 在 session 中 ， 当 在 页 面 中 演 染 视图 时 ， 将 这 个 


结果 传递 给 模板 即 可 。 以 关于 博客 页 面 为 例 ， 将 路 由 处 理 修 改 为 如 下 代码 : 


router.get('/about', function(req, res, next) { 
res.render('about', (user:req.session.user]); 


}); 
同时 ， 将 aside.ejs 文件 修改 为 以 下 代码 : 


<aside> 

<section ie lass=rmain aside açvatarz> 
<img src=" /img/avatar.jpg" alt=""> 

SJ Section 

<ul> 
<li><a hrei "/ MZE T. 75 <li> 
<li><a href="/about"> 关 于 博客 </a></1i> 
<li><a href="friends"> 友 情 链 接 </a></1i> 
<li><a href="/edit"> 撰 写 文章 </a></1i> 
<$ Pfiüuser)r | $> 
<li><a hrei "/logout >A MNA </a></li> 
<% } else { %> 
<li><a href="/login"> 登 录 博 客 </a></1i> 
“Sa | Fom 

< ul> 


WSI 


重新 局 动 项 目 , 可 以 发 现 侧 边 栏 已 经 可 以 通过 判断 用 户 是 否 登录 来 显示 不 同 的 内 容 了 ， 如 


12.24 和 图 12.25 所 示 。 
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Node 的 个 人 博客 


Node.js 技 术 展 望 


作者 : node 发布 时 间 : 2018-01-28 浏览 是 : 5 


Node 


作者 : node 点 布 时 间 : 2018-01-28 浏览 示 :0 


Node.js 高 级 知识 


FEE : node 发 布 时 间 : 2018-01-27 浏览 是 : 46 


Node.js 进 阶 知识 


作者 : node 发 布 时 间 : 2018-01-27 JAF : 19 


NoedeJjs 基 础 知识 
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12.24 用 户 未 登录 的 首页 


Node 的 个 人 博客 


Node.js REE 


EE : node 发 布 时 间 : 2018-01-28 X2 : 5 


Node 


FEE : node 发 布 时 间 : 2018-01-28 浏览 再 :0 


Node.js 高 级 知识 


作者 : node 点 布 时 间 ; 2018-01-27 浏览 去 : 46 


Node.js 进 阶 知识 


作者 : node 发 布 时 间 : 2018-01-27 WSE : 19 


Node.js 基 础 知识 
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12.25 ”用户 已 经 登录 的 首页 
接 下 来 实现 用 户 登 出 博客 的 功能 。 在 index.js 文件 中 添加 以 下 代码 : 


router.get('/logout', function(req, res, next) { 


req.session.user = null; 
res.redirect('/'); 


}); 
重新 局 动 项 目 ， 可 以 发 现 用 户 通 过 单 击 即 可 登 出 博客 。 


12.2.10 ”博客 修改 文章 的 实现 
博客 中 的 文章 难免 会 需要 修改 , 现在 整个 项 目 并 不 能 修改 文章 , 这 里 将 实现 文章 修改 的 功能 。 
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在 index.js 文件 中 添加 以 下 代码 : 


routeLr .get ('/modify/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
var user = req.session.user; 
var query = ' SELECT * FROM article WHERE articleID=' + mysql.escape (articleID); 
TE(t!user) T 
res.redirect('/login'); 
1 
} 
mysql .query (query, functionl(err, rows, fields) { 
jf (err) Í 
console.log (err); 
Ee eu 
} 
var article = rows[0]; 
var title = article.articleTitle; 
var Contenti- article art iciecConiternmbr 
console.log (title,content); 


res.render('modify', {user:user,title: title, content: content}); 


接 下 来 添加 文章 的 视图 模板 ， 在 views 文件 夹 下 新 建 一 个 名 为 modify.ejs 的 模板 文件 ， 写 
入 以 下 代码 : 


<! DOCTYPE htmil> 
<hem Tang zh Cn > 
<head> 
<%— include ("./public/head.ejs")$%> 
— == > 
<body> 
<%— include ("./public/header.ejs")%> 
Section Class- i marn fioathtix”> 
<%- include ("./public/aside.ejs")%> 
<section class="main-articles"> 
< Po rm act ror methnod SPOST elass- "edit > 
<div class="form-group"> 
<label for=""> 标 题 </1abe1> 
<input type="text" name="title" value="<%= title %>"> 
</div> 
<div class="text-group"> 
<label for “">ĎA</lałabel> 


<textarea Name Content >< I COntent > /EextEarea> 
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</div> 
<p><input type="submit" value=" 保 存 "></p> 
</form> 
ee le 
S SECCION: 
<%— include ("./public/footer.ejs")%> 
</body> 
< tmi:> 


重新 启动 项 目 ， 登 录 之 后 在 浏 贤 右 中 输入 localhost:3000/modify/1, WE UE EE — o X 
章 的 修改 页 面 ， 如 图 12.26 所 示 。 


Node 的 个 人 博客 


标题 ”Nodejs 基 下 知识 


Node js88t%Tu165s2 (sr 
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图 12.26 文章 修改 页 面 


这 时 文章 修改 页 面 已 经 可 以 在 登录 之 后 正常 访问 了 。 接 下 来 添加 文章 修改 后 的 数据 库 操 
作 ， 在 index.js 文件 中 添加 以 下 代码 : 


router.post('/modify/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
var user = req.session.user; 
var title = req.body.title; 
var content = req.body.content; 
var query = "UPDATE article SET articleTitle=" + mysql.escape (title) + 
',articleContent=' + mysql.escape (content) + 'WHERE articleID=' + 
mysql.escape (articleID); 
mysql.query (query, function(err, rows, fields) { 
jiE(eëerr) 1 
console.log (err); 
全 在 IE 
} 


res-redirect(['/'")} 
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重新 局 动 项 目 ， 已 经 可 以 正常 修改 文章 内 容 了 。 例如 ， 第 一 篇 文章 修改 后 的 内 容 页 面 如 图 
12.27 所 示 。 


Node 的 个 人 博客 


Node,js 基 础 知识 


作者 : node ”点 布 时 间 : 2018-01-27 ”浏览 如 : 23 


Nodejs 芭 础 知识 疝 妥 介绍 ,Nodejs 呈 一 门 广 过 前 调和 开 友 吉 欢 迎 的 新 寺 技 术 ， 前景 非常 可 观 ， 
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图 12.27 第 一 篇 文章 修改 后 的 内 容 页 面 
接 下 来 在 博客 首页 中 添加 每 篇 文章 修改 的 链接 。 修 改 index.ejs 文件 ， 添 加 编辑 页 面 的 链接 : 


<p> 
<span> 作 者 : <%= articles[i] .articleAuthor %></span> 
<span> 发 布 时 间 : <%= articles[i] .articleTime %></span> 
<span> 浏 览 量 : <%= articles[i].articleClick %></span> 
<% if(user) (%> 
<span class="modify"><a href="/modify/<%= articles[i]-articlerp %>">838 
</a></span> 
< 
</p> 


此 时 ，index.ejs 文件 的 内 容 如 下 : 


<IDOCTYPE html> 
<html lang="zh-cn"> 
<head> 
<%- include ("./public/head.ejs")%> 
</head> 
<body> 
<%— include ("./public/header.ejs")%> 
<section class="main floatfix"> 
<%— include ("./public/aside.ejs")%> 
<section class="main-articles"> 
<ul> 
<4 for(var i = 0; max = articles.: length; i < max; 1it) {3> 
<li class="main-articles-item"> 
<bh2><a href- /articles/<$=- articles|il] articleTDS>"><$= 
articles|i]-articleTitle ></a></h2> 
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<section class="main-articles-items-des"> 
<p> 
<span> 作 者 : <%= articles[i] .articleAuthor %></span> 
<span> 发 布 时间 : <%= articles[i] .articleTime %></span> 
<span> 浏 览 量 : <$%= articles[i] .articleClick %></span> 
< Ti DrSer) 15> 
<span class="modify"><a href="/modify/<%= articles[i]-articlerD %>"w> 
编辑 </a></span> 
<S I $> 
</p> 
ee 
< 
= | x= 
<ol> 
</section> 
<J SECCION: 
<%— include ("./public/footer.ejs")$%> 
</body> 
</html> 


TE main.css 中 添加 以 下 代码 作为 编辑 链接 的 样式 : 


span.modify{ 
Eloa: right; 
} 


span.modify a:hover{ 


color:FF 183D8E; 


重新 启动 项 目 ， 在 登录 之 后 就 可 以 通过 首页 的 编辑 链接 直接 跳 转 至 每 篇 文章 的 编辑 页 面 ， 
如 图 12.28 所 示 。 


Node 的 个 人 博客 


NodeJjs 技 术 展 望 


YE : node 发 布 时 间 : 2018-01-28 3M5 : 5 


Node 


FEE : node 发 布 时 间 : 2018-01-28 浏览 笃 : 
Node.js 高 级 知识 


YEE : node 发 布 时 间 : 2018-01-27 浏览 号: 


Nodejs 进 阶 知识 


作者 : node 发 布 时 间 : 2018-01-27 浏览 再 : 


NodeJjs 基 础 知识 


YEE : node 点 布 时 间 : 2018-01-27 MAE : 24 
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1228 ”添加 编辑 链接 的 首页 
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12.2.11 博客 删除 文章 的 实现 


博客 中 的 文章 难免 会 有 删除 的 时 候 ， 这 里 将 实现 删除 文章 的 功能 。 
在 index.js 文件 中 添加 以 下 代码 : 


router .get('/delete/:articleID'I，function (req, res, next) { 
var articleID = req.params.articleID; 
var user = req-session.user; 
var query = "DELETE FROM article WHERE articleID='" + mysql.escape (articleID); 
if(luser) [í 
res.redirect('/login'); 
CERTEN; 
|; 
biao rel oll y iy ct por (err So EI es | 
res.redirect('/') 
l); 
J); 


接 下 来 在 博客 首页 中 添加 每 篇 文章 删除 的 链接 。 修 改 index.ejs 文件 ， 添 加 删除 文章 的 链接 : 


<p> 

<span> 作 者 : <%= articles[i].articleAuthor %></span> 

<span> 发 布 时 间 : <%= articles[i].articleTime %></span> 

<span> 浏 览 量 : <%= articles[i].articleClick %></span> 

<k 1t (ser) [5> 

<span class="delete"><a href="/delete/<%= articles[i].articleID s>" > ME 
</a></span> 

<span class “modify"><a href "/modify/<%— articles[i]-articlerID $>" >Si 
</a></span> 
< 
< 


此 时 ，index.ejs 文件 内 容 如 下 : 


< !DOCTYPE html> 
—himihiiona zh en > 
<head> 
<%— include("./public/head.ejs")%> 
</head> 
<body> 
<%— include ("./public/header.ejs")%> 
<section class="main floatfix"> 
<%— include("./public/aside.ejs")%> 
<section class="main-articles"> 
<; 1: > 
<š for(var 1 = 0; max = artleles length; 1 < max; 1711) {3> 
<li class="main-articles-item"> 
<H2><a href "articles /<$- articles|i| articlerDi>T><9— 
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articles[il]-articleTitle $></a></h2> 
<section class="main-articles-items-des"> 
<p> 
<span> 作 者 : <%= articles[i] .articleAuthor %></span> 
<span> 发 布 时 间 : <%= articles[i].articleTime %></span> 
<span> 浏 览 量 : “t= articles|il-articleClick $></span> 
<$ Ti (user) [S> 
<span class="delete"><a href="/delete/<%= articles[i].articleID %>"> 
删除 </a></span> 
<span class="modify"><a href="/modify/<%= articles[i].articleID %>"*> 
编辑 </a></span> 
<% > 
</p> 
< Section 
li> 
“a | K> 
</ul> 
</section> 
</section> 
<%— include ("./public/footer.ejs")$%> 
</body> 
</html> 


在 main.css 中 添加 以 下 代码 作为 删除 链接 的 样式 : 


span.delete{ 
Eloat: right? 
} 


span.delete a:hover{ 
color: T183DBE; 


重新 局 动 项 目 ， 登 录 之 后 可 以 通过 首页 的 删除 链接 来 删除 这 篇 文章 。 删除 第 一 篇 文章 后 的 
首页 如 图 12.29 所 示 。 


Node 的 个 人 博客 


Nodejs 技 术 展望 


YEE : node 点 布 了 间 : 2018-01-28 WAF: 5 


Node 


{Z : node 发 布 时 间 : 2018-01-28 Waz 


Node.js 高 级 知识 


#E@ ; node 发 布 时 间 : 2018-01-27 HES : 46 
Nodejjs 进 阶 知识 


YES : node 发 布 时 间 : 2018-01-27 HSE 
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图 12.29 删除 第 一 篇 文章 后 的 首页 
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12.2.12 ”博客 文章 分 页 的 实现 


当 博 客 文章 数量 多 的 时 候 , 将 所 有 文章 放 在 同一 个 页 面 显 然 对 用 户 来 说 是 不 友好 的 。 下 面 
实现 文章 分 页 的 功能 。 

文章 分 页 在 这 里 规定 每 个 页 面 最 多 8 篇 文章 ， 可 利用 URL 中 的 query 字符 串 来 实现 。 数 
据 库 中 的 SQL 查询 可 以 通过 LIMIT 语句 限制 文章 的 篇 数 ， 通 过 得 询 当 前 数据 库 中 文章 的 总 篇 
数 来 判断 是 否 需要 分 页 ， 如 果 文 章 的 总 篇 数 超过 8 扁 束 分 页 ， 不 超过 8 篇 则 不 分 页 。 

在 route 文件 夹 下 的 index js 文件 中 对 首页 的 处 理 修改 为 以 下 代码 : 


router.get('/', function(req, res, next) { 
var page = req.query.page || 1; 
var start = (page — 1) * 8; 
var end = paqe * 8; 
var queryCount = "SELECT COUNT(*) AS articleNum FROM article" 
var queryArticle = 'SELECT * FROM article ORDER BY articleID DESC LIMIT ' + start 
+ 171 + end; 
mysql.query (queryArticle, function(err, rows, fields) 
var articles = rows; 
articles.forEach (function (ele) { 
var year = ele.articleTime.getFullYear (); 
var month = ele.articleTime.getMonth() + 1 > 10 ? 
ele.articleTime.getMonth() : "0' + (ele.articleTime.getMonth() + 1); 
var date = ele.articleTime.getDate() > 10 ? ele.articleTime.getDate() : 
'0 + ele.articleTime.getDate () ; 
ele.articleTime = year + '-' + month + '-' + date; 
1); 
mysql.query (queryCount, function(err, rows, fields) { 
var articleNum = rows[0].articleNum; 
var pageNum = Math.ceil(articleNum / 8); 
res.render ("index", (articles: 
articles,user:req.session.user,pageNum:pageNum, page:page}); 


1); 


在 站 页 的 模板 中 添加 分 页 的 实现 : 


<%if (pageNum > 1) { %> 
Sec tion elass page 
<% for(var i = 1, max = pageNum; i <= max; i++) { %> 
<span <% if(i == paqe) {%> class="active" <% } %>><a 
href=" /?page=<%=i%>"><%=i%></a></span> 
a 1 s 


< [SECCIONS 
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kee í í í í í í í í í í í í í 
此 时 indes.ejs 模板 中 的 代码 应 该 如 下 ; 
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<%— include ("./public/footer.ejs")%> 


</body> 
< 7 H Emil> 


在 main.css 中 添加 分 页 的 样式 ， 写 入 以 下 代码 : 


-pagel 
text-align:center; 
margin Cop- L5px; 

} 

.page span{ 


display: inline- Blocks 


background: #fff; 
midten: 24px; 
margin: 0 5p; 
line-height: 24px; 
height: 24px; 

} 

.page span al 
display: Diock; 

) 

page span.active aí 
background: #183D8E; 
color:tfErFI; 

) 

.page span:hover at 
background: #183D8E; 
co ror: Ef 


重新 局 动 项 目 ， 添 加 几 篇 文章 ， 当 文章 的 篇 数 大 于 8 篇 时 就 会 出 现 分 页 ， 


篇 时 不 会 分 页 ， 单 击 分 页 按钮 可 以 实现 跳 转 ， 如 图 12.30 和 图 12.31 所 示 。 


Node 的 个 人 博客 


NodeJjs 技 术 展 望 
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1230 ”文章 篇 数 小 于 8 篇 时 不 分 页 


文章 篇 数 小 于 8 
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安 卓 开发 知识 总 结 
{ES : node 发 布 时 间 : 2018-01-30 浏览 竺 :0 


java 知识 总 结 


作者 : node 发 布 时 间 : 2018-01-30 XR : 0 
Ruby 知 识 总 结 


作者 : node 发 布 时 间 ; 2018-01-30 浏 监 至 :0 


JavaScript 知 识 总 结 


作者 ; node 2#768]8]: 2018-01-30 Ma : 0 


Node.js 技 术 展 望 


IES : node 发 布 弄 问 : 2018-01-28 RRE : 5 


Node 


{ES : node 发 布 时 间 : 2018-01-28 浏览 至 :0 


12.31 文章 篇 数 大 于 8 篇 时 分 页 
文章 分 页 的 功能 就 实现 了 。 


12.3 项 目 总 结 


在 本 章 中 ， 我 们 通过 一 个 简单 的 个 人 博客 项 目 进一步 了 解 了 Express 框架 和 MySQL 的 使 
用 ， 通 过 前 问 界 面 设计 、 数 据 库 设 计 、 后 端 路 由 开发 介绍 了 整个 项 目的 开发 流程 。 当 然 ， 有 兴 
趣 的 读者 还 可 以 继续 优化 这 个 项 目 ， 如 添加 评论 功能 、 标 签 分 类 功能 等 。 
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第 13 章 
使 用 Meteor+MongoDB 
开 友 任务 ) 育 单 


一 个 任务 清单 项 目 是 众多 语言 和 框 染 学 习 的 第 一 步 。 任 务 清单 就 是 平时 提 到 的 ToDo List. 
一 个 任务 清单 项 目 虽 然 简 单 ， 但 是 往往 能 展现 这 个 框架 的 核心 。Meteor 是 一 个 里 程 碑 式 的 全 
栈 开发 平台 。 正 如 其 名 ，Meteor 的 魅力 在 于 快速 开 肥 、 减 少 重复 工作 。MongoDB 是 Meteor 
官方 推荐 使 用 的 数据 库 。 本 章 将 通过 实际 编码 来 实现 一 个 任务 清单 项 目 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

© j MySQL 数据 库 并 进行 操作 。 

@ 连接 MongoDB 数据 库 并 进行 操作 。 

© 了 解数 据 库 的 基础 知识 。 


项 目 准备 


13.1.1 Meteor 和 MongoDB 的 安装 

Meteor 和 MongoDB 作为 本 次 开发 的 平台 和 使 用 的 数据 库 ， 在 项 目 开 始 时 ， 应 该 确保 
Meteor 和 MongoDB 已 经 安装 好 。 

AR Meteor 的 安装 ， 只 需要 在 官方 网 站 下 载 对 应 的 操作 系统 的 版 本 进行 安装 即 可 。Meteor 
的 官方 网 站 地 址 是 https://www.meteor.com/， 在 安装 之 前 应 该 确保 已 经 安装 Nodejs， 如 图 13.1 所 
不 。 
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XH S80 EEV PO #26) ISM ”帮助 (H) 


Š Install Meteorjs x + 


< C Q G) Ñ https://www.meteor.com o s W| | Q E= I Ü S ph: pp: o C 


Mi AN DEVELOPERS SHOWCASE SOLUTIONS COMPANY Login ! Registe 


INSTALL 


Current version: 1.7.0.3 


/iew Release Notes 


OSX / LINUX WINDOWS 


Run the following command In your terminal to Install the First Install Cnocolatey, then run this command using an 


latest official Meteor release: Administrator command prompt 


curl https://install.meteor.com/ | sh choco install meteor 


* For compoetibilty, Linux binories ore built with CentOS 6.4 i386/!ernd54. * Meteor supports Windows 7/Windows Server 2008 R2 ond up. 
* iOS development requires the letest Xcode. es The installer uses Chocoletey, which has its own requirements. 
* Disabling antivirus [Windows Defender, etc.) will improve performance. 


* iOS development is not supported. 


图 13.1 安装 Meteor 
MongoDB 的 安装 同样 是 在 官方 网 站 下 载 对 应 的 版 本 即 可 ， 在 前 面 的 章节 中 已 经 详细 介绍 
T, LERAAR Yo MongoDB 的 官方 网 站 地 址 是 https://www.mongodb.com/。 
Meteor 和 MongoDB 安装 完成 之 后 ， 使 用 meteor--version 命令 查看 Meteor 版 本 以 确保 安 
装 成 功 : 


meteor --version 


确保 安装 完成 之 后 使 用 meteor create list 命令 来 创建 项 目 : 


meteor create list 


经 过 一 段 时 间 的 安装 ， 安 装 完成 之 后 在 命令 行 中 可 以 看 到 Meteor 已 经 指示 了 如 何 局 动 整 
个 项 目 ， 如 图 13.2 所 示 。 


W wae. USCI © MIU UJ IWE na CLUN 7 L CALC 
Created a new Meteor app in list. 
To run your new app: 


esl ls =e 
meteor 


If you are new to Meteor, try some of the learning resources here: 
https://www. meteor. com Learn 


meteor create --bare to create an empty app. 
meteor create --full to create a scaffolded app. 


图 13.2 ”项 目 初始 化 完成 后 的 界面 
按照 指示 使 用 命令 来 局 动 这 个 项 目 : 
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caa rist 


meteor 


局 动 这 个 项 目的 过 程 中 ，Meteor 也 同时 局 动 了 MongoDB, 命令 行 界面 指示 
口 己 经 俘 止 项 目 运行 的 命令 ， 如 图 13.3 所 示 。 


= 
HII 
sl 
ai 
= 
šE 


> Started proxy. 
> Started MongoDB. 
> Started your app. 


=> App running at: http://localhost:3000/ 
Type Control-C twice to stob. 


图 13.3 项 目 启动 的 命令 行 界面 
在 浏览 器 中 输入 http://localhost:3000/， 可 以 看 到 Meteor 默认 初始 页 面 ， 如 图 13.4 所 示 。 


Welcome to Meteor! 
Click Me 


You've pressed the button 0 times. 


Learn Meteor! 


e Do the Tutorial 

e Follow the Guide 
e Read the Docs 

e Discussions 


图 13.4 Meteor 默认 初始 页 面 
在 Meteor 项 目 中 使 用 命令 行 meteor mongo 即 可 打开 MongoDB， 这 对 开发 中 数据 的 初始 
测试 非常 有 用 。 
13.1.2 项 目 设 计 


一 个 任务 清单 应 该 具备 的 基本 功能 是 可 以 增加 任务 、 删 除 任务 、 完 成 任务 ,可 用 一 张 简单 
的 草图 表示 ， 如 图 13.5 所 示 。 


图 13.5 项 目 草 图 
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在 数据 库 方面 的 设计 需要 表明 当前 任务 的 状态 、 任 务 的 具体 内 容 ， 在 MongoDB 中 表示 类 
似 于 : 
{ 

本 本 7 


content: ' 任 务 一 '， 


complete: false 


完成 基本 的 功能 设计 之 后 需要 对 项 目的 目录 结构 进行 设计 。 在 项 目的 根 目录 下 新 建 一 个 
public 文件 夹 作 为 存放 评 态 资源 的 文件 来 ， 新 建 一 个 imports 文件 夹 作 为 开 友 过 程 中 主要 使 用 
的 文件 夹 , 在 imports 文件 夹 下 新 建 一 个 名 为 models 的 文件 夹 作 为 数据 的 文件 来, 新 建 一 个 名 
为 controllers 的 文件 夹 作 为 主要 的 逻辑 控制 文件 夹 ， 同 时 新 建 一 个 名 为 views 的 文件 夹 作为 
HTML 文件 存放 的 文件 灯 ， 整 个 项 目的 目录 结构 大 致 如 图 13.6 所 示 。 


图 13.6 项 目 目录 结构 
此 时 项 目 开 发 的 准备 已 经 完成 。 


项 目 开发 


13.2.1 项 目 展示 功能 开发 
按照 上 文中 文件 目录 结构 功能 的 划分 ， 将 client 文件 夹 中 的 main.html 文件 内 容 修改 为 以 
下 内 容 : 


<head> 
<title> 任 务 清单 </title> 
</head> 
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在 views 文件 夹 下 新 建 一 个 名 为 index.html 的 文件 ， 写 入 以 下 内 容 : 


<body> 
cio elass com pre r> 
{{> listHead}} 
FI> li sSETrnpukbE li 
{1> YTistContent]|] 
</div> 


</body> 


在 这 个 结构 中 已 经 非常 明确 地 将 页 面 划分 成 了 三 部 分 , 在 views 文件 夹 中 新 建 三 个 分 别名 
为 listHead.html、listInput.html、listContent.html 的 文件 。 其 中 ，listHead.html 文件 的 内 容 如 下 : 


<! 一 定义 1istHead 模板 --> 
<Template name = listHead > 
<h1> 任 务 清单 </h1> 


</Template> 


listInput.html 文件 的 内 容 如 下 : 
<! 一 定义 1istInput 模板 --> 


<Template name="listInput"> 
< Form action > 
<input type="text" placeholder=" 添 加 一 个 待 办 事项 "> 
</form> 


</Template> 


listContent.html 文件 的 内 容 如 下 : 


<! 一 定义 1istcontent 模板 --> 
<template name="listContent"> 
<ul class="listContainer"> 
<! 一 循环 lists 内 容 ， 每 项 都 使 用 1istItem 模板 --> 
{{#each lists}} 
{{> listItem}} 
Iteachil 
“yal> 
</template> 


这 个 文件 中 再 次 将 任务 的 条 数 分 隔 为 不 同 的 模板 。 再 新 建 一 个 名 为 listItem.html 的 文件 ， 
写 入 以 下 内 容 : 
<! 一 定义 1istItem 模板 --> 
<template name="listItem"> 
< i> 
<input type="checkbox"> 
{{content}} 
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<input type="button" value=" 删 除 "> 
< 


</template> 


此 时 基本 的 模板 内 容 开 发 完毕 ， 接 下 来 试 着 填充 一 些 数据 使 整个 内 容 可 见 。 

在 controllers 文件 夹 中 新 建 名 为 index.js 和 listContent.js 的 文件 。 其 中 ，index.js 文件 作为 
该 文件 夹 中 所 有 文件 的 导出 文件 ，listContent.js 文件 对 应 于 listContent.html 文件 中 的 数据 。 

lE] listContent.js 文件 中 写 入 以 下 内 容 : 


import { Template } from 'meteor/templating'; 


import '../views/listContent.html'; 


/* 定 义 1istCcontent 的 数据 */ 
Template.listContent.helpers((í( 
pests () [ 
return [{content: ' 任 务 一 '}, (content: ' 任 务 二 '}] 
} 
1); 


最 后 利用 index Js 文件 将 其 导出 即 可 : 


import '../views/listHead.html'; 
import '".. /wiews/listInput.html'; 
import '../views/listItem.html'; 


import './listContent'; 


将 client 文件 夹 下 main.js 文件 中 的 内 容 修 改 为 以 下 内 容 : 
import 大 porEsreconErolers > 
import './../imports/views/index.html'; 

利用 命令 行 工 具 运 行 meteor run 指令 即 可 在 本 地 服务 器 的 3000 端口 看 到 如 图 13.7 所 示 的 
页 面 ， 说 明 数 据 已 经 可 以 在 页 面 中 展示 出 来 了 。 


任务 清单 


添加 一 个 待 办 事项 


。 日 任务 一 | 删除 
° 目 任务 二 | 删除 


13.7 初始 页 面 


13.2.2 项 目 页 面 美化 
一 个 优秀 的 应 用 必然 少不了 漂亮 、 美观 的 UI 界面 , 这 一 小 节 将 着 重 介绍 页 面 的 美化 工作 。 
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在 public 文件 夹 中 添加 一 个 名 为 bg.jpg 的 文件 ， 因 为 public 文件 夹 中 的 文件 将 会 发 送 到 
client， 所 以 直接 使 用 即 可 。 向 main.css 中 写 入 以 下 内 容 : 
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width:1 100%; 
list-style:none; 
background: Tfff; 
padding: T0Opx 53; 
margin- P T O> 0 
HOX- S dn le DON; 
position: relative; 
tont- SIze: 14px; 
height: 40px; 
line-height: 20px; 

} 

container ul i -deletei 
position:absolute; 
EARE: 2; 
color:f8c0ü0707; 

} 

-container ul Tu inputi 
widEN: LPZ: 
height:18px; 
position:absolute; 
laa EE b; 
background: #fff; 


打开 页 面 ， 可 以 看 到 整个 页 面 变 得 更 加 美观 了 ， 如 图 13.8 所 示 。 


任务 清单 


138 ”优化 后 的 页 面 


13.23 项目 数 据 库 开发 


Meteor 使 用 MongoDB EX Ja im KE. MongoDB 使 用 集合 和 文档 的 概念 。 创 建 一 个 集 
合 只 需要 使 用 new Mongo.Collection0 即 可 ， 同 时 在 Meteor 中 数据 库 可 以 直接 映射 到 前 应。 在 
models 文件 夹 中 新 建 一 个 名 为 mdex.js 的 文件 ,利用 这 个 文件 来 创建 MongoDB 数据 库 的 文档 ， 
在 这 个 文件 中 写 入 以 下 内 容 : 
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/* 从 meteor 中 引入 mongo* / 


import { Mongo ) from 'meteor/mongo'; 


/* 实 例 化 lists 集合 */ 


const Lists = new Mongo.Collection('lists'); 


export default Lists; 


完成 文档 的 创建 之 后 需要 将 数据 展现 在 前 端 页 面 。 在 前 和 面 的 革 节 中 ， 我 们 在 listContent 
模板 上 使 用 的 是 自己 填 入 的 数据 ， 而 在 实际 中 需要 真正 使 用 数据 库 中 的 数据 ， 只 需要 在 
listContent 中 将 数据 库 中 的 数据 查找 出 来 填充 即 可 ,在 MongoDB 中 使 用 find0 方 法 即 可 将 所 有 
的 数据 以 数组 的 形式 查找 出 来 。 将 listContent 的 文件 内 容 修 改 为 以 下 内 容 : 
/* 从 meteor 中 引入 Template*/ 
import { Template } from 'meteor/templating'; 
import Lists from *. 7  /models7index"; 


import '../views/listContent.html'; 


/* 将 Lists 集合 的 数据 找 出 作为 listcontent 模板 的 数据 */ 


Template.listContent.helpers({ 
aps t s IA 
return Liasts`Ffind(1]); 
} 
)); 
因为 创建 这 个 文档 的 同时 也 需要 在 server 端 执行 ， 所 以 将 其 导入 即 可 ， 也 就 是 将 server 
文件 夹 下 的 main js 文件 修改 为 以 下 内 容 : 
import { Meteor } from 'meteor/meteor'; 


import '../imports/models'; 


/*meteor 项 目 启动 时 触发 */ 
Meteor.startup(() => { 
// code to run on server at startup 


I); 


此 时 页 面 中 没有 任何 任务 内 容 ， 因 为 数据 库 中 没有 内 容 。 可 以 通过 命令 行 填充 部 分 数据 ， 
在 项 目 根 目录 下 使 用 命令 行 工具 运行 命令 meteor mongo: 


meteor monqo 


连接 好 MongoDB 数据 库 之 后 即 可 使 用 命令 进行 数据 库 的 增删 查 改 。 运行 以 下 命令 手动 增 
加 两 条 数据 : 


db- listsiinsert (Iconternmt: 'hetftlo word"); 


db.lists.insert ((content:'hello meteor')); 
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运行 完毕 ， 可 以 看 到 项 目 页 面 同时 出 现 了 这 两 项 任务 ， 如 图 13.9 所 示 。 


|] hello world m: 


[| hello meteor 


ET ë ë 
图 13.9 ”从 数据 库 中 调 取 数 据 


13.2.4 项目 操作 人 逻辑 开发 


此 时 页 面 中 已 经 可 以 展示 数据 库 中 的 数据 了 , 但 是 并 不 能 实现 任务 的 增删 , 本 小 节 将 实现 
这 些 功 能 。 

Meteor 中 每 个 模板 的 事件 可 以 使 用 Template body.events 定义 。 同 时 ， 因 为 前 端 已 经 具备 
了 操作 数据 库 的 功能 ， 所 以 直接 在 事件 中 对 数据 进行 操作 即 可 ， 不 再 需要 像 传统 的 项 目 那 样 ， 
提交 到 后 端 来 处 理 。 

IB] controllers 文件 夹 中 的 listContentjs 文件 中 添加 增加 任务 的 功能 。 添 加 任务 使 用 submit 
事件 进行 处 理 即 可 ， 即 添加 以 下 内 容 : 
/* 定 义 相应 的 事件 */ 


Template.body.events ({ 


/* 提 交 任 务 的 事件 处 理 */ 
'submit form' (event)t 
event .preventDefault (() ; 
const text = event.target.text.value; 
(L (exit Erim) Tength 5 > 0 
ELSES insert (content: CexEr)? 


event.target.text.value = ''; 


在 浏览 器 页 面 的 输入 框 中 添加 任务 内 容 ， 按 Enter 键 之 后 就 可 以 看 到 任务 已 经 添加 到 任务 
栏 中 了 。 

得 益 于 Meteor 的 模板 数据 上 下 文 ， 删 除 任务 实现 也 是 非常 简单 的 ， 可 继续 在 events 中 添 
加 以 下 内 容 : 
/* 删 除 任务 的 事件 处 理 函 数 */ 
"click .delete"() 


Lists.remove (T id: this- id)); 


} 
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更 新 任务 是 否 完成 的 功能 实现 如 下 : 
/* 更 新 任务 是 否 完成 的 事件 处 理 函 数 */ 


Change .listContainer li'(event) { 


Luists WPMateltinse eid P SSO [Compl eted: ESConoLeEeG ii: 


整体 事件 处 理 代 码 如 下 : 
/* 定 义 相应 的 事件 */ 


Template.body.events ({ 


/* 提 交 任 务 的 事件 处 理 */ 
'submit form' (even 七 ) { 
console. Tfog(thisy; 
event .preventDefaul-t () ; 
const text = event.target.text.value; 
Jf (text  tErim() lengeh >of 
LiscS- -insert ({content: text); 
event .target.text.value = ''; 
] 
]; 


/* 删 除 任务 的 事件 处 理 函 数 */ 

“click .delete" () I 
console l log(this}; 
Tisi s remogel lid This Piq), 


} ， 


/* 更 新 任务 是 否 完成 的 事件 处 理 函 数 */ 


"Change .listContainer li' (event)t 


Lists update (rnis nir IFSEC: COn ered: it thiS'Comieredqii)]- 
} 
Eh 


此 时 在 浏览 器 中 已 经 可 以 添加 和 删除 任务 了 , 但 是 并 不 能 直观 地 发 现任 务 是 否 完成 , 可 以 
通过 判断 任务 是 否 完成 来 将 相应 的 任务 以 不 同 的 样式 标识 出 来 。 将 listttem html 文件 修改 为 以 
下 内 容 : 


<template name="listItem"> 
<! 一 根据 任务 是 否 完成 来 显示 不 同 的 样式 --> 
<li class="{{#if completed}} completed {{/if}}"> 
<input type="checkbox"> 
{{content}} 


<span class="delete"> 删 除 </span> 
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< le 


</template> 


回 main.css 中 添加 以 下 内 容 : 


Container ul li.completed{ 
text decoration: line-through; 
cölor:fb/b6b6; 


此 时 已 经 可 以 同 项 目 中 添加 、 删 除 和 更 新 任务 ， 完成 了 项 目的 基本 功能 。 不 过 为 了 使 新 添 
加 的 项 目 可 以 在 整个 项 目 列 表 的 最 前 方 ， 还 需要 对 项 目的 创建 时 间 进 行 倒序 排序 。 新 建 一 个 
createAt 字段 ， 将 添加 任务 的 事件 处 理 函 数 修 改 为 以 下 内 容 : 


/* 提 交 任 务 的 事件 处 理 */ 
"Submit Torm (evert)] í 
event.preventDefault () ; 


const text = event.target.text.value; 


/* 将 新 任务 存放 在 数据 库 中 */ 
E(text trim() length > O01 
Lists- -Insert ({content: tezt; CreatedAt: new Date (l); 
event .target.text .Value = !'!'; 
) 
} ， 


将 任务 的 展示 数据 进行 排序 ， 修 改 代码 为 以 下 内 容 : 
/* 定 义 数据 */ 


Template.listContent.helpers({ 
LISESI F] 


/* 倒 序 排列 任务 */ 
return lasts EGG Sort lereaEedae Se Dp); 
} 
}); 


任务 项 目 就 可 以 按照 创建 时 间 倒 序 排列 了 。 
在 一 个 任务 清单 中 , 同样 应 该 使 用 户 能 够 清楚 地 了 解 到 哪些 任务 完成 了 、 哪 些 任 务 没有 完 
成 。 下 面 在 项 目 中 添加 这 个 功能 。 将 views 文件 夹 下 的 listHead.html 文件 修改 为 以 下 内 容 : 


<Template name="listHead"> 


<h1> 任 务 清单 

<select name="type” class="lists-type"> 
<option value=" 全 部 "> 全 部 </option> 
<option value=" 已 完成 "> 已 完成 </option> 
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<option value=" 未 完成 "> 未 完成 </option> 
</select> 
</B> 
</Template> 


同时 在 main.css 文件 中 添加 以 下 内 容 作 为 样式 : 


select.lists-type{ 
font-size: 14px; 
display: block: 
Float: right; 
height: 40px; 
border: lpx solid +III; 
Borgder racuns:- 5x 
mel 0 
position: absolute; 
right:26; 
COD- IDX; 


在 这 里 需要 思考 一 个 问题 :如 何 才 能 保存 用 户 选择 的 清单 展示 类 型 呢 ? 最 简单 的 方法 就 是 
利用 一 个 变量 ,然而 listHead 和 listContent 属于 不 同 的 模板 并 且 不 属于 同一 个 文件 ， 也 就 是 说 
一 个 简单 的 JavaScript 变量 并 不 能 完成 这 个 任务 。 这 时 可 以 利用 Meteor 中 的 session。 将 变量 
作为 session 存储 在 内 存 中 就 可 以 方便 地 取 用 了 。 在 controllers 文件 夹 中 新 建 一 个 名 为 
listHead.js 的 文件 ， 写 入 以 下 内 容 : 


import { Template } from 'meteor/templating'; 


/* 引 入 Session*/ 


import { Session } from 'meteor/session'; 


/* 事 件 处 理 */ 
Template.listHead.events ({ 
"Change .lists-type' (event, instance) { 


const index = event.target .selectedIndex; 


/* 设 置 session*/ 
Session.set ('listType', index); 
} 
}); 
此 时 展示 类 型 已 经 存储 在 session 中 了 ， 只 需要 在 调用 数据 的 时 候 将 session 取出 来 , 根据 
这 个 值 来 对 数据 进行 选择 即 可 。 将 listContent 模板 的 helpers 取 用 修改 为 以 下 内 容 : 


msts( [ 
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/* 取 出 session 中 listType 的 值 */ 
const listType = Session.get ("listType'); 


/* 根 据 1istType 的 值 来 显示 不 同 的 任务 内 容 */ 
if (listType)t 

if (listType === 1) 

/* 显 示 所 有 已 经 完成 的 任务 */ 


return Lists.find({completed: true), (sort: {createdAt: -1}}) 
} else if(listType === 2) { 
/* 显 示 所 有 未 完成 的 任务 */ 


return Lists.find({completed: false}, (sort: (createdAt: -1))) 
} 


/* 显 示 所 有 任务 */ 


reburmi bists Engl sort: cecreatedAt:P LP); 


同样 在 插入 数据 的 时 候 应 该 设置 一 个 completed:false 字段 , 将 表单 提交 事件 修改 为 以 下 内 容 : 


import { Template } from 'meteor/templating'; 


import Lists from './../models/indezx'; 


/* 定 义 事件 */ 
Template.listInput.events({ 
"submit form' (event) { 
event .preventDefault (() ; 
const text = event.target.text.value; 
If {texE-trim{)- length > 0) | 
Lists.insert ((content: text, createdAt: new Date(), completed: false)); 


event.target.text.value = ''; 


I. 
此 时 在 浏览 器 的 http://losthost:3000 Hki n] B pha PPEeok wsHT 3 HTI T o 


2.9 发 布 与 订阅 
在 上 文 的 Meteor 项 目 中 ， 在 服务 端 和 浏览 器 端 都 可 以 操作 数据 库 ， 并 且 所 有 的 数据 都 同 


步 映射 到 了 客户 端 。 这 在 实际 开发 中 是 不 推荐 的 。 当 然 这 是 因为 Meteor 项 目 默 认 集 成 了 
autopublish 包 , 所 有 的 数据 都 会 上 自动 映射 到 客户 端 ， 因 此 在 项 目 上 线 之 前 我 们 应 该 把 这 个 包 去 
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把 ， 同 时 去 抒 的 包 还 有 insecure。 
删除 一 个 Meteor 包 是 非常 简单 的 ， 可 以 使 用 以 下 命令 删除 上 和 面 的 两 个 包 : 


meteor remove autopublish insecure 
运行 完成 之 后 可 以 在 命令 行 中 看 到 这 两 个 包 已 经 删除 的 提示 ， 如 图 13.10 所 示 。 


Changes to your project s package verslo 


autopublish removed from your project 


insecure removed from your project 


insecure: removed dependency 
autopublish: removed dependency 


13.10 删除 包 


删除 这 两 个 包 之 后 我 们 需要 使 用 Meteor 的 发 布 一 订阅 模式 获取 数据 ， 同 时 需要 利用 
Meteor.methods 来 定义 相应 的 方法 。 

首先 我 们 需要 在 创建 集合 之 后 定义 对 应 的 操作 数据 库 的 方法 ， 将 models 文件 夹 下 的 
index.js 文件 内 容 修 改 为 以 下 内 容 : 
/* 引 入 mongo* / 


import { Mongo ) from 'meteor/mongo'; 


/* 创 建 集合 */ 


const Lists = new Mongo.Collection('lists'); 


/* 定 义 操作 这 个 集合 的 方法 */ 


Meteor.methods ({ 


/* 新 建 任务 的 方法 */ 
"iists -insert (text) 1 
Lists > insertlt 
content: text, 
createdAt: new Date(), 
completed: false 
H: 
} ， 


/* 删 除 任务 的 方法 */ 
iists-delete (id) I 
Lists.remove ([ id: id])); 


]; 


/* 更 新 任务 是 否 完成 的 方法 */ 
'lists.update' (id,completed) { 

Lists.update (id, {$set: (completed: completed))); 
) 
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DE 


/* 导 出 */ 
export default Lists; 
在 这 段 代 码 中 定义 了 相应 的 操作 数据 库 的 方法 , 因此 在 客户 端 触发 各 个 事件 时 需要 调用 相 
应 的 数据 库 操作 方法 来 对 数据 进行 操作 。 
在 Meteor 中 直接 使 用 Meteor.call 方法 即 可 调用 定义 在 Meteor.methods 下 的 方法 。 这 个 函 
数 的 第 一 个 参数 是 需要 调用 的 函数 的 名 字 ， 其 他 参数 对 应 于 调用 函数 需要 传 入 的 参数 值 。 
根据 Meteor 的 数据 上 下 文 ， 非 常 容易 得 到 这 些 方 法 的 参数 ， 因 此 将 添加 任务 的 事件 处 理 
函数 修改 为 以 下 内 容 : 
/* 新 建 任务 的 事件 处 理 */ 
'submit form' (event) (í 
event .preventDefault (); 


const text = event.target.text .value; 
I i [text Crim) lengen > 0 | 


/* 调 用 1ists.insert 方法 */ 
Meteor.call('lists.insert', text); 
event .target.text -Value = "1 7 
} 
he 


删除 任务 的 事件 处 理 函 数 如 下 : 
/* 删 除 任务 的 事件 处 理 函 数 */ 


'click .delete'() í 
/* 调 用 lists.delete M% / 
MECCeEoreCalPI LisStS delete this Fid); 
} ， 


更 新 任务 是 否 完成 的 事件 处 理 函 数 如 下 : 
/* 更 新 任务 完成 与 否 的 事件 处 理 函数 */ 


"Change .listContainer li'(event)( 
/* 调 用 lists.update 函数 */ 
Meteor.call('lists.update', this. id, !this.completed); 


这 相当 于 我 们 对 项 目的 事件 处 理 函 数 都 进行 了 一 次 重 写 。 
利用 Meteor 的 发 布 一 订阅 机 制 , 我们 需要 判断 是 否 为 服务 端 ， 如 果 是 服务 疹 就 进行 发 布 ; 
如 果 是 客户 端 就 进行 订阅 。 
使 用 Meteor.isServer 就 可 以 确保 其 中 的 代码 只 运行 在 服务 端 , 使 用 Meteor.publish0 方 法 即 
可 发 布 。 在 models 文件 夹 下 的 index.js 文件 中 添加 以 下 内 容 : 
/* 进 行 发 布 */ 
if (Meteor.isServer) { 
Meteor.publish("'lists', function () [Í 
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这 个 文件 的 所 有 内 容 如 下 。 


在 服务 端 进行 发 布 之 后 ， 在 客户 端 使 用 Meteor.subscribe 方法 就 可 以 订阅 了 。 如 果 在 项 目 
创建 的 时 候 进 行 订阅 ， 就 可 以 将 订阅 放 在 Template.body.onCreated0 中 ， 代 码 如 下 : 


打开 浏览 器 ， 项 目 依 旧 正 常 运 行 ， 如 图 13.11 所 示 。 
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怀 加 一 个 待 办 事项 


| hello javascript 


13.11 项 目 运行 截图 
至 此 ， 一 个 简单 的 任务 清单 项 目 就 完成 了 。 


13.4 项目 总 结 


本 章 通过 一 个 任务 清单 项 目 简单 了 解 了 Meteor 项 目的 开发 。 从 中 可 以 发 现 Meteor FR 
度 非常 快 。 这 是 一 个 里 程 碑 式 的 创新 。 感 兴趣 的 读者 可 以 对 这 个 项 目 进行 进一步 的 开发 。 
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NPM 已 经 成 为 当今 最 大 的 包 管 理 平 台 。 开 发 一 个 流行 的 Node.js 模块 是 众多 Node.js 爱好 
者 的 梦想 ， 因 此 本 章 将 开发 一 个 简单 的 Nodejs 包 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

© 开发 Node.js 包 的 要 点 。 

@ Node.js 包 的 发 布 。 


Node.js 包 的 设计 


Node.js 模块 数量 的 快速 增加 极 大 地 促进 了 Node.js 技术 的 发 展 。 现 在 Node.js 和 JavaScript 
的 开源 模块 数量 已 经 远 远 超过 其 他 语言 ，NPM 也 一 跃 成 为 最 大 的 包 管 理 平 台 。 这 是 一 个 民 性 
的 循环 。 

作为 一 个 开发 者 ,参与 到 开源 社区 中 , 不 仅 可 以 提高 个 人 技术 ,还 可 以 促进 各 大 语言 技术 
的 发 展 。 本 章 将 简单 开发 一 个 package， 并 将 其 发 布 到 NPM 上 。 

一 个 Node.js 的 package 必须 有 一 个 index.js 文件 作为 入 口 文 件 ， 其 他 库 文件 应 存放 在 libs 
文件 夹 下 。 一 个 合格 的 NPM 的 package 应 该 经 过 测试 并 存 有 必要 的 文档 ， 因 此 需要 建立 一 个 
test 和 doc 文件 夹 作为 测试 文件 和 文档 文件 存放 的 文件 夹 . 整 个 项 目的 项 目 目录 如 图 14.1 所 示 。 


doc 


@ libs 


A test 


index.Js 


图 14.1 项 目 目录 结构 


本 章 开 发 的 NPM 包 的 定位 是 一 个 没有 任何 依赖 的 文件 操作 库 。 在 本 书 前 面 的 章节 中 已 经 
详细 介绍 了 Node. js 的 文件 系统 功能 ， 不 过 Node.js 的 文件 操作 API 并 不 能 让 我 们 轻易 地 操作 
文件 ， 因 此 一 个 易于 操作 文件 的 库 在 实际 开 友 中 是 非常 有 必要 的 。 

在 libs 文件 夹 下 新 建 mkdir.js、rmdir.js、touch.js、remove.js 四 个 文件 作为 创建 文件 夹 、 删 
除 文件 光 、 新 建文 件 、 删 除 文件 功能 的 开发 文件 ， 如 图 14.2 所 示 。 
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G mkdirjs JavaScript File 
G removejs JavaScript File 
G rmdirjs JavaScript File 
G touchjs JavaScript File 


图 14.2 libs 文件 夹 下 的 文件 


Node.js 创建 文件 夹 的 不 足 在 于 不 能 创建 一 个 多 层级 的 文件 玉 。 例 如 ， 需 要 创建 一 个 
test/hello 文件 夹 时 ， 如 果 test 文件 夹 不 存在， 那么 这 个 文件 夹 下 的 hello 文件 夹 创建 将 会 失败 。 
在 实际 开发 中 ， 这 样 的 需求 是 非常 弟 见 的 。 在 这 里 规定 创建 文件 夹 时 必须 以 相对 路 径 ./ 表 示 ， 
也 就 是 说 要 逐 层 创建 文件 来 , 因此 需要 分 割 创建 文件 夹 的 路 径 。 可 以 简单 地 将 字符 串 转 化 为 数 
组 ， 创 建文 件 夹 时 拼接 字符 串 即 可 。 在 mkdirjjs 文件 中 写 入 以 下 内 容 : 

Function mkdir (path; caliback) mi 


/* 将 路 径 按 斜 线 分 割 为 数组 */ 


var pathArr = path.toString().split('"/'"); 


/* 逐 个 遍历 路 径 数组 中 的 值 并 创建 相应 的 目录 */ 

for(var ıı < pathArr"lengEh; IFF) 
var newPath = pathArr.slice(0,i+1).join('/'); 
fs.mkdirSync (newPath); 


} 
callback &e callback(ls 


这 样 就 可 以 一 次 性 创建 多 层 目 录 了 。 为 了 防止 重复 创建 , 在 创建 文件 夹 之 前 先 判 断 文 件 夹 
是 否 存 在 ， 从 而 判断 出 是 否 创建 文件 夹 ， 然 后 导出 这 个 方法 即 可 。 整 个 文件 的 内 容 如 下 : 
/* 引 入 fs 模块 */ 


var fs = require('fs'); 


function mkdir (path; Callback) i 
/* 将 路 径 按 斜 线 分 割 为 数组 */ 


var pathArr = path. Lostring() -split > 


/* 逐 个 遍历 路 径 数组 中 的 值 */ 
tor (var i lpatharr length; 1t) f 


var newPath = pathArr.slice(0,i+1).join('/'); 


/* 判 断路 径 是 否 存 在 */ 
var exists = fs.existsSync (newPath); 
TE (exioslisjnel 
CEELEN; 


} 
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删除 文件 夹 的 思路 类 似 , 不 过 在 删除 文件 夹 之 前 需要 删除 其 子 文件 及 子 文件 夹 , 删除 文字 
文件 夹 只 需要 使 用 迭代 的 思想 即 可 。rmdirjs 文件 的 内 容 如 下 : 
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创建 文件 的 思路 是 逐 级 解析 文件 路 径 中 包含 的 一 级 级 目录 之 后 最 终 对 应 的 文件 。touch_.js 


文件 的 内 容 如 下 : 
/* 引 入 fs 模块 */ 


var fs = require('fs'); 


Function touchi(pnath callback} j 
/* 将 路 径 按 斜 线 分 割 为 数组 */ 


var pathArr = .path-Lo5tring()-split ("7"); 


/* 遍 历 读 取 到 的 数组 值 */ 
FOF (Vac al patnArr a lien ET 


var newPath = pathArr.slice(0,i+1) .join('/'); 


/* 判 断 文件 或 者 文件 夹 是 否 存在 */ 

var exists = fs.existsSync (newPath);/ 
if (exists) { 

return; 


} 


/* 若 是 数组 的 最 后 一 项 则 创建 文件 */ 

if(i === (pathArr.length - 1)) (Í 
var fd = fs.openSync (newPath, 'w'); 
£S- closeSyne (fd)? 

} else{ 


/ +E IER ea EER */ 
fs.mkdirSync (newPath); 
} 
} 
callback && callback () ; 
) 


/* 导 出 方法 */ 


module.exports = touch; 


删除 文件 的 功能 非常 简单 ， 删 除 之 前 只 需要 判断 提供 的 路 径 是 否 为 文件 即 可 。remove.js 


文件 内 容 如 下 : 
/* 引 入 fs 模块 */ 


var fs = require ("fs5'); 


function remove (path, callback) { 


/* 判 断路 径 是 否 存在 */ 
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var exists = fs.existsSync (path); 
nexnsts)el 

EarEny 

} 

/* 判 断 传 入 的 路 径 是 否 为 文件 */ 

工 EEESSsEaESyncrpaeRnhaspae ae 1 
fs ` untinkSync (path): 

callback && callback(); 

} 


module.exports = remove; 


复制 文件 及 文件 夹 的 功能 稍微 复杂 一 些 , 在 复制 的 同时 需要 创建 文件 夹 和 文件 ， 因此 可 以 
直接 使 用 上 文中 开发 的 mkdir 方 法 ,并 对 文件 的 内 容 进行 写 入 (使 用 一 个 简单 的 流 即 可 )。copy-.js 
文件 的 内 容 如 下 : 

/* 引 入 fs 模块 */ 


var fs = require(('fs'); 


/* 引 入 mkdir 方法 */ 


var mkdir = require('./mkdir'}; 


unction Copy (Sre; disti | 
/* 引 入 被 复制 的 路 径 是 否 存在 */ 


var existsSrc = fs.existsSync(src); 


/* 引 入 输出 的 路 径 是 否 存 在 */ 
var existsDist = fs.existsSync (dist); 
var filename, distPath SrTCPatN, readAble,;, uriteaAnles 
TE[lexistsSre) T 

Te E tiri; 


} 


/* 输 出 路 径 不 存在 则 创建 文件 夹 */ 
Tf(l!exrstsbpbist) £ 
maa (cis sS y; 
} 


/* 判 断 是 否 是 文件 复制 */ 


SWEET et 


/* 利 用 正则 获取 路 径 中 的 文件 名 */ 
filename = src- toString{l} match(/NX/ ([2N/]+])S7/3y [0]; 
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distPath = dist + filename; 


/* 利 用 文件 流 写 入 文件 内 容 */ 


readAble = fs.createReadStream(src); 
writeAble = fs.createWriteStream(distPath); 


readAble.pipe (writeAble); 


—_ 


elser 


/* 路 径 是 文件 夹 的 处 理 逻 辑 */ 

yar path i PFS- redsciinrSyrnmec src); 

Eor (var i O; r= paths. length: iti) 
arePath = sre I "*/' t paths[il; 
distPath = dist + '/' + paths[i]; 


/* 是 文件 夹 中 的 文件 则 通过 文件 流 创建 和 写 入 文件 */ 
Tf (fs `sSLatSyme(SrcPpath)'ispite( )) I 
readAble = fs.createReadStream(srcPath); 
writeAble = fs. _createwWwriteStream(distBath); 
readAble.pipe (writeAble); 
} else if (fs.statSync (srcPath) .isDirectory()) ( 


/* 是 文件 夹 则 和 迭代 方法 */ 


Copy (SECPAEN dnSteacn) 


/* 导 出 方法 */ 
module .exports = copy; 
剪 切 文件 功能 可 以 通过 rename 方法 实现 ， 只 不 过 在 剪 切 的 过 程 中 需要 判断 剪 切 的 是 文件 
还 是 文件 夹 。cutjjs 文件 的 内 容 如 下 : 
/* 引 入 fs 模块 */ 


var fs = require ('fs'); 


/* 引 入 mkdir 方法 */ 


var mkdir = require ("./mkdir"); 


Gunectnon eculesre drsEeEy | 


/* 引 入 被 剪 切 的 路 径 是 否 存在 */ 


var existsSrc = fs.existsSync (src); 


/* 引 入 输出 的 路 径 是 否 存 在 */ 


var existsDist = fs.existsSync (dist); 
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var filename, distBath, srcBath, readAble, writeAble; 
TE(lexrstsSrc) 4 
return; 


} 


/* 输 出 路 径 不 存在 则 创建 文件 夹 */ 
TE T1existspast)ymi 
mkdir(dist); 
) 


/* 判 断 是 否 是 文件 剪 切 */ 
1 (tS StatSync(Src)" TsSsETer)) pi 
filename = src-toS5tring() match (/N7/ ([“N/Z]+)S7ZQ) [01]; 
distPath = dist + filename; 
fs.renameSync (src, distPath); 
} else { 


/* 若 为 文件 夹 则 读 取 文 件 夹 */ 

var paths = fs.readdirSync (src); 

For var sr SO pons lengeBe TS 
srcPath = src + '/' + paths[i]; 
distPath = dist + "'/*" + paths[i]; 
fs.renameSync(srcPath, distpath); 

} 

} 
} 


/* 导 出 方法 */ 


module.exports = cut; 


最 后 通过 index.js 文件 将 所 有 的 方法 导出 。index.js 文件 的 内 容 如 下 : 


/* 引 入 方法 */ 

var mkdir = require ('./libs/mkdir'); 
var remove = require ('./libs/remove'); 
var rmdir — recqgüuire(" /lips/rmdir"); 
var. couch = require{":/libs/touch:js"; 
var copy = require ('./libs/copy-js'); 


yat cut = reguire("./1libs/cut:js'}; 
/* 导 出 方法 */ 
module.exports = { 


mkdir: mkdir, 
remove: remove, 
Tm r Erma; 
Couch: Couch, 
copy: copy, 
CUE -T CUC 


' 


这 样 一 个 简单 的 文件 操作 库 就 创建 完成 了 。 当 然 , 目前 其 功能 非 第 简陋 ， 有 兴趣 的 读者 不 
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妨 继续 丰富 相关 的 功能 。 


14.2 发 布 到 NPM 上 


目前 NPM 是 Nodejjs 最 大 的 包 官 理 平 台 ， 将 目 己 开 友 的 Node.js 包 发 布 到 NPM 上 既 方 便 
其 他 开发 者 下 载 使 用 这 个 包 ， 也 可 以 让 其 他 开发 者 检验 这 个 包 是 否 含有 未 解决 的 Bug。 

在 NPM 包 发 布 之 前 需要 在 NPM 官方 网 站 上 进行 注册 。 在 NPM 的 官方 网 站 上 单 击 Sign Up 
填写 相应 的 账号 信息 ， 即 可 进行 NPM 账号 的 注册 ， 如 图 14.3 所 示 。 


Your email address will show on your profile page, but npm will 


never share or sell it. 


Username 


In order to protectyour account, make sure your password: 


è is longer than 7 characters 

è Does not match or significantly contain your 
username, e.g. do not use 'username123'. 

è Is not a member of this list of common passwords 

s Is not a member of the Have | Been Pwned breach 
database 


回 Sign up for the npm Weekly 


F Agree to the End User License Agreement and the 


Create an Account 


or, Login 


图 14.3 NPM 账号 注册 页 面 


当然 ， 也 可 以 通过 命令 行 来 创建 NPM 账号。 运行 npm adduser 命令 之 后 填写 相应 的 信息 
即 可 完成 一 个 NPM 包 的 注册 ， 如 图 14.4 所 示 。 
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账号 注册 完成 后 可 使 用 npm login 命令 填写 相应 的 账号 信息 来 登录 已 经 注册 好 的 账号 。 
npm login 


使 用 npm init 命令 生成 一 个 package Json 文件 ， 填 写 相 应 的 Node.js 包 信 息 ， 内 容 如 下 : 


"name": "fs-easy", 
"VerSTOn = “D: O: 1”; 
"description": "An easy use libraray for node.js", 
cmarn ss Endex: JSU 
zda rectoriest: I 
ole ei ae ee 
ECESE S test. 
}, 
SOEs A] 
greste Eeske 
}, 
“TOeDOSIiEOry” si] 
EVDe S > tm, 
"urli": "w"qit+https://qithub.com/huruji/fs-easy.qit" 
]; 
"keywords": [ 
FS 
"node.js" 
] ， 
lel rly 
licensen s mhk5e m 
Dis. A 
"url": "https://github.com/huruji/fs-easy/issues" 
]; 
"homepage": "https://github.com/huruji/fs-easy#readme" 


在 发 布 之 前 ， 我 们 需要 让 开发 者 了 解 发 布 包 的 作用 ， 所 以 要 为 开 友 者 提供 一 个 API 说 明 
和 简单 的 运行 示例 。 当 一 个 包 的 API 简单 时 ， 可 以 通过 一 个 readme.md 文件 来 简要 说 明 ; 当 
API 比较 复杂 时 ， 可 以 在 上 文中 创建 的 doc 文件 夹 下 进行 详细 的 说 明 。 

发 布 一 个 NPM 包 时 只 需要 使 用 简单 的 npm publish 命令 即 可 : 
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npm publish 
NPM 包 发 布 成 功 之 后 ， 在 NPM 官方 网 站 登录 目 己 的 账号 ， 在 Profile 面板 下 即 可 看 到 发 
布 的 NPM 包 ， 如 图 14.5 所 示 。 


huruji 


1 Package by huruji 


fs-casy - v0.0.2 - An easy use libraray for node.js 


Your Account 


sign up for private modules 
create an organization 
update your profile 


huruji3@foxmail.com 


@huruji on npm 
14.5 NPM 个 人 主页 


单 击 相应 的 包 之 后 束 可 以 进入 相应 包 的 主页 。 在 这 个 包 的 Stats 下 可 以 看 到 下 载 情况 ， 以 
了 解 自 己 开发 的 这 个 Node.js 的 流行 程度 ， 如 图 14.6 所 示 。 


Stats 
22,280 downloads in the las... 
121,265 downloads in the l... 


540,251 downloads in the l... 


62 open issues on GitHub 


15 open pull requests on Git... 


14.6 Vue.js 的 Stats 情况 


当 一 个 Nodejs BÆ NPM 上 发 布 之 后 ， 就 可 以 使 用 npm install 命令 来 下 载 相应 的 包 了 : 


npm install fs-easy 


当 这 个 包 下 载 成 功 之 后 就 可 以 在 package json 中 看 到 相应 的 包 和 包 版 本 信息 了 。 在 
node modules 文件 来 中 可 以 看 到 下 载 的 包 。 


图 标 和 徽章 


在 GitHub 上 的 一 些 项 目 中 ， 第 第 会 在 readme.md 上 出 现 图 标 ， 例 如 Vue.js 的 readme.md 
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build passing downloads 564k/month license MIT 


© Chrome 


图 14.7 Vue.js 的 项 目 图 标 
为 自己 的 项 目 添加 相应 的 状态 图 标 不 仅 可 以 使 自己 的 项 目 更 加 靠 谱 、 更 加 高 端 ， 还 有 利 


于 项 目的 推广 。 


生成 状态 图 标的 方式 比较 简单 ， 首 推 shields 网 站 【网址 是 https:/shields.io/) 。 在 这 个 网 
站 的 首页 可 以 看 到 相应 的 图 标 ， 如 图 14.8 所 示 。 


Travis branch: uild passin 


Travis: 


Wercker: 
TeamCity CodeBetter: 


build failure 


TeamCity (simple build status): 


(full build status): 
@© build failing 


build not found 


AppVeyor: 
AppVeyor branch: 
Codeship: 
Codeship: 


图 14.8 


https://img.shields.io/travis/USER/REPO.svg 

https://img. shields. io/travis/USER/REPO/BRANCH. svg 
https://img.shields.io/wercker/ci/wercker/docs.svg 
https://img.shields.io/teamcity/codebetter/bt428. svg 
https://img.shields. io/teamcity/http/teamcity. jetbrains, com/s/bt345. 
https://img.shields.io/teancity/http/teamcity. jetbrains. com/e/bt345.9 
https://img.shields. io/appveyor/ci/gruntjs/grunt. svg 

https://img. shields. io/appveyor/ci/gruntjs/grunt/master, svg 


https://img.shields.io/codeship/déc1ddd0-16a3-0132-5£85-2e35c05e22b1. 


https://img.shields.1io/codeship/d6c1ddd0-16a3-0132-5f85-2e35c05e22b1/ 


httos://imag.shields.io/maanumci/ci/96ffb83fa?700£069024921b0702e76ff.9 


shields 首页 提供 的 项 目 图 标 


直接 在 这 个 网 站 的 首页 输入 框 中 写 入 相应 项 目的 GitHub 地 址 即 可 生成 一 些 图 标 。 例 如 ， 
输入 express 的 项 目地 址 ， 束 会 目 动 生成 推荐 的 issues、forks、stars、license、Twitter 图 标 徽 


章 ， 如 图 14.9 所 示 。 


GitHub issues; https://img.shields.io/github/issues/expressjs/express.svg 


GitHub forks: 
GitHub stars: 
GitHub license: 


Twitter: 


W Tweet 


https://img. shields.io/github/forks/expressjs/express. svg 
https://img. shields.io/github/stars/expressjs/express. svg 
https://imq.shields.io/badqe/license-MIT-blue.svq 


https://img.shields.io/twitter/url/https/github.com/expressjs/express.svg?style=social 


14.9 shields 推荐 的 图 标 
将 这 些 图 标 引 入 readme.md 的 方式 也 非常 简单 ， 只 需要 按照 markdown 的 语法 将 这 个 图 标 


后 面 的 图 标 地 址 写 入 readme.md 就 可 以 了 。 


当然 这 个 网 站 同时 文 持 目 定 义 项 目的 图 标 。 在 需要 展示 项 目 大 小 、 项 目 运 行 平台 、 项 目 


版 本 等 信息 时 束 可 以 使 用 目 定 义 图 标 。 
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可 以 在 项 目的 推荐 图 标 之 后 选择 自 定 义 图 标的 名 称 、 状 态 和 图 标 颜 色 ， 如 图 14.10 所 示 。 


(JU BAD 
color Make Badge 


https://img. shields .io/badge/<SUBJECT>-<STATUS>-<COLOR>. svg 


or Space -> Space 


en B color green H color yellowqgreen B color yellow W color orange HB color red H color hghtgrey MH color blue H color ff69b3 


14.10 shields 自 定 义 图 标 


在 输入 框 中 输入 相应 的 内 容 ， 完 成 之 后 单 击 Make Badge 按钮 即 可 生成 。 
当然 在 开源 项 目 中 还 常常 会 看 到 build passing 这 样 的 图 标 〈 见 图 14.11) 。 这 种 图 标 可 以 
通过 Travis-cli 网 站 获取 。 


build failure 国有 build GE 


图 14.11 build 图 标 


6... Node.js v10 中 的 N-API 应 用 


14.4.1 N-API 介绍 


我 们 先 来 讲 一 讲 什么 是 N-API， 它 具体 是 做 什么 用 的 。 就 如 同 前 文中 编写 的 Node 扩展 一 
样 ， 很 多 开发 者 都 或 多 或 少 地 遇 到 过 升级 Node 版 本 后 ， 导 致 Node 扩展 编译 失败 的 情况 。 主 
要 就 是 因为 Node 扩展 严重 依赖 于 Google Chrome v8 所 暴露 的 API， 而 恰恰 Node 不 同 版 本 所 
依赖 的 v8 版 本 可 能 不 同 。 所 以 ， 一 旦 用 户 升级 Node 版 本 ， 原 先 运 行 正常 的 Node 扩展 就 很 可 
能 会 编译 失败 。 

FÆ, Node.js 就 推出 了 N-API 功能 来 解决 Node 跨 版 本 之 间 原 生 模 块 的 兼容 问题 。 严 格 
来 讲 , N-API 是 在 Nodejjs 升级 到 v8.0 版 本 时 提 增 加 的 新 特性 , 但 此 时 的 N-API 只 是 试验 模式 ， 
使 用 该 模块 的 时 候 会 在 stderr 或 stdout 中 输出 一 段 警告 ,我 们 可 以 无 视 此 警告 .不 过 ,在 Node. js 
最 新 发 布 的 v10 版 本 中 ，N-API 功能 就 是 默认 支持 的 了 。 


N-API 之 所 以 能 够 避免 版 本 兼容 的 问题 ,主要 原因 就 是 N-API 是 使 用 C 语 言 来 写 原 生 Node 
扩展 的 ， 这 样 就 与 底层 JS 引擎 (v8) 无关。 因此 ， 只 要 N-API 暴露 的 API 足够 稳定 ， 那 么 
Node 扩展 的 编写 者 就 不 用 过 分 担忧 Node 升级 所 带 来 的 兼容 问题 。 
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14.42 N-API 环境 准备 

使 用 N-API 功能 首先 要 确保 系统 中 安装 了 Node.js v10 版 本 (至 少 是 Node.js v8 以 上 版 
本 ) ， 安 装 方法 参考 本 书 第 1 章 中 的 内 容 。 

然后 ， 继 续 安 装 node-gyp 扩展 插件 ， 因 为 之 后 编译 用 户 自 定 义 Node 扩展 时 需要 ， 有 具体 方 
法 如 下 : 
npm install node-gyp 


最 后 就 可 以 创建 项 目 目录 ， 并 初始 化 package.json 文件 了 ， 具 体 方法 如 下 : 


mkdir n-api-test & cd n-api-test # 项 目 目录 名 根据 需要 来 定义 
opa inii F + 初始 化 package.json 文件 ， 使 用 -下 选项 


1443 ”编写 扩展 


项 目 目 录 创 建 好 之 后 ， 就 可 以 编写 扩展 文件 了 了。 首先 ， 在 项 目 目 录 下 创建 一 个 src 文件 目 
K P C 语言 扩展 源 文件 ) 。 具 体 方法 如 下 : 


MAIT STC 


然后 ， 继 续 创建 addon.c 作为 Node 扩展 的 源 文件 。 具 体 方法 如 下 ; 


touch addon.c # linux 环境 
cd.>addon.c # windows 环境 


编辑 test.c， 输 入 如 下 内 容 。 


#include <node api.h> 


napi value Method(napi env env, napi callback info into) f{ 
napi value napiVal; 
consti cehar* str HellonN APTI; 
size t Str len = strientstr]s 
NAPI CALL{eny,; napi create string utiBt(tenv str, SEr len; snapiyall); 


return napiVal; 


void Init(napi env envy napi value exports) | 
napi property descriptor desc = DECLARE NAPI PROPERTY ("moduleHello", Method); 
NAPI CALL (env; Hapi define properties (eny; exports; l; desci; 
FEEUrNTEXPOEES? 


} 


NAPI MODULE ("moduleHello", Init); 
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14.4.4 ”编译 扩展 

编写 好 扩展 文件 后 , 就 可 以 编译 该 扩展 文件 了 。 首先 , 定义 一 个 编译 描述 文件 binding.gyp， 
具体 内 容 如 下 : 
{ 


eames 
J 
“target name"; "addons, 
"sources": "sre/addon cù] 
} 
] 
} 


然后 ， 运 行 如 下 命令 进行 编译 : 


node-gyp rebuild 


14.4.5 ”调用 扩展 

为 了 调用 Node 扩展 ， 需 要 先 安装 bindings 扩展 插件 。 具 体内 容 如 下 : 
npm install bindings 

然后 ， 创 建 appjs 入 口 文件 ， 调 用 刚 编译 的 扩展 。 具 体内 容 如 下 : 


var addon = require ('bindings') ('addon'); 


console.log (addon.moduleHello());}; 


下 面 就 可 以 运行 代码 了 。 由 于 N-API 当前 尚 处 于 Experimental 阶段 ， 记 得 加 上 


--napi-modules 标记 。 
node --napi-modules app.js 


在 控制 人 台 输 出 内 容 的 效果 如 图 14.12 所 示 。 


Node.js command prompt 


əde 一 napi-modules app. js 
allo N-API! 


图 14.12 调用 N-API 效果 


16.D 总 结 


在 开发 Nodejjs 项 目的 过 程 中 ， 学 会 使 用 各 种 各 样 的 包 会 给 开发 提供 大 量 的 便捷 服务 。 在 
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开发 Node js 包 的 时 候 ，package.json 不 仅 应 该 作为 项 目的 配置 文件 ， 也 应 该 是 项 目的 依赖 摘 
述 文件 。 在 实际 开发 过 程 中 ,提供 稳定 的 测试 和 使 用 示例 是 让 人 们 信赖 的 依据 。 同 时 , 项 目的 
推广 也 离 不 开 一 个 简洁 完整 的 文档 说 明 。 一 个 完整 的 文档 说 明 可 以 让 其 他 开发 者 迅速 了 解 项 目 
的 作用 ， 进 而 使 用 这 个 项 目 。 在 开发 中 ， 将 项 目 同时 发 布 到 NPM 是 一 个 不 错 的 习惯 ， 以 便 其 
他 开发 者 下 载 和 使 用 这 个 Node.js 包 。 
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